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1.0 INTRODUCTION 


1.1 ABBREVIATIONS AND TERMS USED IN THIS MANUAL 


ACF/NCP/VS 


ACF/VTAM, 


ACF/VTAME 


BSC 

BT AM 
CA 
CICS/VS 
ICCF 
LU 
NCCF 
NPDA 
PU 
SDLC 
SIPO/ZE 
SNA 
VSE 


Advanced Communications Function for Network Control 
Program/Virtual Storage 

Advanced Communications Function for Virtual 
Telecommunications Access Method, Version 2 for DOS/VSE 
Cunless otherwise specified) 

Advanced Communications Function for Virtual 
Telecommunications Access Method Entry 

Binary Synchronous Control 

Basic Telecommunication Access Method 

Communications Adapter 

Customer Information Control System/Virtual Storage 
Interactive Computing and Control Facility 

Logical Unit 

Network Communications Control Facility 

Network Problem Determination Application 

Physical Unit 

Synchronous Data Link Control 

System Installation Productivity Option/Extended 
Systems Network Architecture 

Virtual Systems Extended 
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1.2 WHO THIS PRIMER IS FOR 


1.2.1 The User 


This publication is primarily for persons responsible for installing 
ACF/VTAM including the appropriate IBM 3270, IBM 364x and CICS/VS support 
as well as the integration of the IBM 4331 in a multi domain environment. 
It assumes that the reader is familiar with VSE SIPO/E 3.1 and has a work- 
ing knowledge of VSE system operation, job control statements and data 
management. He is also able to define and operate the CICS/VS environment 
and has a basic knowledge of SNA and ACF/VTAM. 


Different types of users are considered in this primer : 

1. The First Time Users 
Installations which are starting the first time on an IBM 4331 with 
the SIPO/E. Tables or definitions are not currently available to 
describe the environment. 


2. The former BTAM-ES Users 


The SIPO/E 3.1 is installed. The production system is still running 
with CICS/VS - BTAM. 


3. The former ACF/VTAME Users 


The production system is running in a ‘SIPO/E 3.1 environment. CICS/VS 
is using ACF/VTAME as the TP access method. 


This document is intended to assist the user in the installation of 
ACF/VTAM in a VSE SIPOZE Version 3 Release 1 environment on a IBM 4331 and 
in the operation and management of the network. 


The document outlines the installation and definition steps and discusses 
migration aspects for the former BTAM-ES and ACF/VTAME user. 


Basic operation and problem determination procedures are discussed for 
single and multt-system networks. 


This publication is specifically directed towards the installation of IBM 
3270, IBM 364X, ACF/VTAM and CICS/VS systems, and updates and expands the 


Small Communication Systems Installation Primer IBM 4331/ACF/VTAME in the 
following areas: 
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e Loop Adapter devices (e.g. IBM 364X) 
° Set-up of physical devices 

e Device tests 

e CICS-ACF/VTAM dependencies 

© Migration from BTAM-ES and ACF/VTAME 
° CNM products 


° Switched lines 


The primer is also valuable for those users who still will be running with 
ACF/VTAME but have a need to install products of the above mentioned 
areas. 


This primer does not cover the installation of IBM 3705 communications 
controllers. Information of this topic can be found in the Small Communi- 


cation Systems Installation Primer VSE System IPO/ZE & IBM 3705-80 


Also this primer does not cover the SIPO/VE 3.1 Basic Installation but 
hints are provided in Chapter 4, section ‘System Initialization". 


1.2.3 The Environment 


The IBM #351 Processor 


The IBM 4331 Processor is an intermediate-scale, general purpose process- 
or. It offers System/360 and System/370 compatible architecture, as well 
as advanced functions provided by System/370, such as support of virtual 
storage, and uses large-scale integrated technology. 


The IBM 4331 Processor can be installed as a stand-alone system to handle 
all traditional application areas. It can also be incorporated in the com- 
munication networks of large installations and multiple-system installa- 
tions. 


The IBM 3270 Information Display System 
The IBM 3270 System offers the user a wide selection of components and 
configurations that can be tailored to meet the needs of alphameric and 
graphic (Cprogrammed symbolsJapplications in both monochrome and color. 
Terminals from the IBM 3270 System can be attached to the: 


@ IBM 4331 Display/Printer Adapter, 
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® IBM 4331 LOOP Adapter Clocal/remote), 

° IBM 4331 Communications Adapter (Clocal/remote), 
e IBM 4331 channels. 

° IBM 3705 Cnot discussed in this primer). 


The IBM 3178 is a functional alternative to an IBM 3278 model 2 display. 
Definitions shown in this document that apply to the 3278 model 2 also 
apply to the 3178. 


The IBM 364X Devices 


The IBM 364X devices are industry terminals which cover the needs of a 
typical manufacturing environment. These devices are locally attached to 
the IBM 4331 Loop Adapter without a control unit. If they are attached 
remotely, an IBM 3843 control unit 15 necessary. 


Figure 1 on page 5 shows the networking capabilities of the IBM 4331 pro- 
cessor. 


VSE_ SIPO/E 3.1 


The IBM 4331 processor is supported by VSE SIPO/E 3.1. The DB/DC or DC 
Version needs to be installed. 


ACF/VTAM Version 2 (VSE) 


The ACF/VTAM Version 2 is an IBM program product for users of Disk Operat- 
ing System/Virtual Storage Extended CDOS/VSE) with the VSE/Advanced 
Function program product. ACF/VTAM provides support for terminals on the 


® Display/Printer Adapter (DPA), 
e LOOP Adapter, 
a Communications Adapter (CA) 


of the IBM 4331 processor and also provides support for various channel 
attached terminals. | 

A channel attached 3705 with ACF/NCP is also supported with ACF/VTAM, and 
this may be used concurrently with CAs. The 3705 1s not covered in this 
primer. 


The communication part of an ACF/VTAM application program Ce.g. CICS/VS) 
uses ACF/VTAM macro instructions to communicate with terminals and log- 
ical units, i.e. with devices or programs by which an end user Capplica- 
tion program, a terminal operator, or a input/output mechanism) gains 
access to the data communication network, which is also being controlled 
by ACF/VTAM. 


ACF/VTAM can be used ina single system environment, as well as ina multi 
system environment using the multi-system networking functions. In a mul- 
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Figure 1. Network Capabilities of the IBM 4331 
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tiple systems environment, ACF/VTAM may be connected through an SDLC 
cross-domain link to other processors. 


This allows application programs and terminals that are controlled by 
ACF/VTAM to communicate with application programs in another domain, i.e. 
in an area controlled by another host processor, of the multiple system 
network. It also allows terminals controlled by another domain in the net 
work to communicate with ACF/VTAM application programs. 


crces/vs 


The IBM Customer Information Control System/Virtual Storage (CICS/VS) is 
a general purpose data base/data communication system. It runs under con- 
trol of VSE and uses standard access methods. It is treated as an applica- 
tion program in an ACF/VTAM environment. 


1.3 HOW THIS PRIMER IS ORGANIZED 


This primer contains twelve chapters, dealing with steps for planning, 
defining, installing, executing and testing the communications system, or 
parts of it, and a number of appendices, containing detailed information, 
such as configurations and other examples. As stated before, this publica- 
tion contains information needed to get the ACF/VTAM system started. Fur- 
ther information covers the customization of ACF/VTAM applications as 
CICS/VS, NCCF, NPDA in an IBM 4331 SIPOZE 3.1 anvironment. 


Chapter 2 contains a brief review of SNA terms used in this publica- 
tion and describes the overall ACF/VTAM functions. 


Chapter 3 describes the preparation of local, remote devices and the 
CPU for the implementation of a communication system. 


Chapter 4 describes the installation of ACF/VTAM in a SIPO/E 3.1 envi- 
ronment. | 
Also, hints are provided for customization in a SIPO 3.1 anvi- 
ronment. 


Chapter 5 describes the customization process and the tests for a sin- 
gle system environment. 


Chapter 6 describes the customization process and the tests for a multi 
system environment. 


Chapter 7 discusses the definition and operation of switched lines. 


Chapter 8 discusses storage requirements, performance and tuning of 
 ACF/VTAM. 


Chapter 9 


Chapter 10 


Chapter ll 


Chapter 12 


Appendix A 


Appendix B 
Appendix C 


Appendix D 
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discusses methods for problem determination in an ACF/VTAM 
network. It also shows examples of some common problems. 


covers the migration of an existing ACF/VTAME network to an 
ACF/VTAM network. 


covers the migration of an existing BTAM-ES installation to 
an ACF/VTAM communication system. 


leads the user in the customization process of the CNM pro- 
ducts available with SIPO/E 3.1. system. 


contains a configuration example of a running multi~system 
environment. 


contains suggested naming conventions. 
contains a documentation summary. 


contains the Configuration Documentation Worksheets. 


1.4 RELATED PUBLICATIONS 


The titles and form numbers of associated publications, to which the read- 
er can refer for detailed information, are summarized in Appendix C. 


1.5 HOW TO READ THIS PRINER 


The step-by-step approach of this document makes it easy for the reader to 
follow and implement the outlined procedures. Only the chapters contain- 
ing the required information need be read. 


The First Time Users should read 


e Chapter 1 to &, 


® Chapter 5 or 6, 


® Chapter 8 and 9. 


The former BTAM-ES users should read 


@ Chapter 1 to 4, 


e Chapter 11, 


© Chapter 5 or 6, 
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° Chapter 8 and 3. 

The former ACF/VTAME users should read 

° Chapter 4, 

° Chapter 8, 9, 10. 

Users of CNM products (NCCF,NPDA,OCCF) should read 

° Chapter 12. 

Users with installations having SWitched Lines should read 


e Chapter 7. 
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2.0 SNA AND ACF/VTAM V2 OVERVIEW 


This chapter describes the components of an ACF/VTAM network and the way 
the elements of the networks are controlled and shared through ACF/VTAM. 


2.1 SNA OVERVIEW AND ACF/VTAM'S RELATIONSHIP TO SNA 


Data communication is the process of transmitting and receiving data over 
communication facilities such as telephone lines. Systems Network Archi- 
tecture (SNA) defines the structure and protocols Crequest/response 
rules) for such a network. 


ACF/VTAM provides, amongst other things, one of the SNA-defined network 
components, the System Services Control Point (SSCP), which is used to 
control the network. Additionally, ACF/VTAM allows application programs 
Ce.g. CICS, POWER) to use the network to communicate with other network 
users, such as terminals attached to tha network, or with other ACF/VTAM 
application programs. 


A network may contain more than one SSCP Ce.g. another ACF/VTAM in another 
host). The network user of one domain can communicate with the network 
users associated with other SSCPs. This communication is called 
cross-domain. 


A network user gains access to the network facilities through a logical 
unit (LU). For example, an ACF/VTAM application program using ACF/VTAM 
macro instructions is identified with an LU and uses it to access the net~- 
work. SNA terminals also implement LUs; e.g. each IBM 3270 display termi- 
nal is associated with an LU. 


In order for two LUs (e.g. an application program anda display terminal) 
to communicate with each other, a logical connection called a S@ssion must 
be established between these two LUs. The SSCP assists the LUs in estab- 
lishing this session. The session concept is described below in more 
detail. 


In any given session, one LU is the primary LU (PLU) and the other is the 
secondary LU (SLU). The PLU has more responsibility in establishing the 
session. 


Ganerally, ACF/VTAM application program LUs are PLUs and terminal LUs are 
SLUs. However, if two application programs communicate with each other, 
one LU will act as the PLU and one as the SLU. 


Before two LUs set up a session, they both must agree ona set of protocols 


that will be used for the duration of the session. This set of protocols 
is determined by session Parameters, which may be user defined in a logon 
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mode table. Generally, the PLU suggests the session parameters and the 
SLU either agrees to them or rejects them. 


Every LU in the network is associated with a Physical unit (PU) . The PU 
works with the SSCP to manage the network configuration, e.g. to determine 
which network elements are currently usable. There is a PU supplied by 
ACF/VTAM in each host processor containing ACF/VTAM. There is also a PU in 
each cluster controller and each communications controller. ACF/VTAM 
also contains an internal PU that controls hest logical units such as 
application programs. 


The elements of an ACF/VTAM network are organized into groups of major and 
minor nodes. Major and minor nodes are the controllable elements of the 
network. A major node is a set of minor nodes. Each major node can be con- 
trolled Cactivated or deactivated, displayed, etc.) as a whole or portions 
of it can be controlled through its minor nodes. For example, application 
program major nodes consist of one or more application program LU defi- 
nitions, which are the minor nodes. Local SNA major nodes consist of one 
or more SNA PUs attached via a channel to the host computer.’ The minor 
nodes are the physical units Ccontrollers) and their associated logical 
units (terminals). 


Major nodes are defined differently from minor nodes. Minor nodes are 
defined by ACF/VTAM definition statements; the name of each minor node is 
the label coded in the corresponding statement. Major nodes are defined 
by combining the definition statements for the minor nodes into sets and 
by cataloging these sets in the source statement library. The name of each 
major node is the book name assigned to the set. 


In a multi-domain network, information about other domains must be pro- 
vided to enable communication between the two domains. The other domains 
are identified by defining a Cross Domain Resource Manager (CDRM) for each 
domain. A CDRM, which is part of the System Services Control Point 
CSSCP), 18 a program which controls the resources in its domain and that 
has the ability to communicate with other domains. Any resource in a 
domain that may be used in another domain is called Cross Domain Resource 
(CDRSC). CDRSCs, like CDRMs, are defined in major and minor nodes. 


There are two important characteristics of ACF/VTAM’s use of SNA. First, 
ACF/VTAM uses the processing capabilities of communication controllers 
and terminal products to move part of the communication control from the 
host processor to the network. Second, ACF/VTAM allows its application 
programs to use lines, controllers and LUs as shareable resources. 


2.@ SNA SESSION CONCEPT 


Before two LUs (e.g. an application and a terminal) can communicate with 
each other, they must be bound together in a Sessicn. 
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In an ACF/VTAM network, several types of sessions exist: 
e SSCP-PU sessions, 

e SSCP-LU sessions, 

° LU-LU sessions, 


@ and SSCP-SSCP sessions Conly in a multi domain network). 


The first three session types are hierarchical, i.e. the higher session 
must have been established bafore the lower session can be started. 


After ACF/VTAM is started, the SSCP establishes (within its domain) an 
SSCP-PU -Sessi0n with -each physical unit which is defined with 
ISTATUS=ACTIVE in a major node listed in the configuration list 
CATCCONxx). 


ror other PUs this session can also be established by a 
"VV NET,ACT,ID=puname' operator command. 


The successful establishment of the SSCP-PU session is indicated by the 
ACF/VTAM message: puname ACTIVE. This also means that the physical path 
to the PU is available. 


Once the SSCP-PU session is started, the SSCP can establish an SSCP-LU 
session for each logical unit with ISTATUS=ACTIVE associated with the PU. 
The same rules apply for the LU as for the PU. 


This session can also be established by a 'V NET,ACT,ID=luname’ operator 
command. 


Finally, when a pair of LUs are to communicate with each other, the SSCP 
must establish an LU-LU Session between them. Usually between any two LUs 
only a single LU-LU session can exist; however, some logical units 
(CICS/VS as a ACF/VTAM application program) can have multiple concurrent 

sessions (called parallel sessions) between the same two LUs. | 
After the LU-LU session establishment, ACF/VTAM is ready to handle the 
data transfer between these LUs (e.g. application-terminal). 


For cross-domain communication, ACF/VTAM must first establish a session 
between its SSCP and the SSCP of another SNA access method in the associ- 
ated domain. This session, called an SSCP-SSCP Session, must exist before 
any logical units can communicate cross-domain. It is started by the 
activation of the two participating CDRMs in each host. 
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2.3 FUNCTIONAL OVERVIEN OF ACF/VTAM (VSE) 


To support the communication within a single or multi-domain network 
ACF/VTAM performs the following functions: 


° controls the allocation of network resources Ce.g. lines, 
controllers, terminals) 


e permits application programs to share network resources 
e permits use of resources without specific knowledge of their location 


° establishes, controls, and terminates sessions between LUs in the 
network 


® facilitates the transfer of data between points in the network 


° permits the operation of the network to be monitored and altered by 
the ACF/VTAM operator 


° permits the network configuration to be changed while the network is 
being used 


® initiates datection and correction of problems in the operation of the 
netnork 


In addition, ACF/VTAM provides an integrated multi-system networking 
facility. As part of a multiple-domain network, ACF/VTAM: 


® permits an application program in one domain to communicate with 
applications or terminals in other domains 


© permits a terminal of one host processor to communicate with applica- 
tions in another host's domain : 


® establishes, controls, and terminates sessions with application pro- 
grams and terminals in other parts of the multiple-domain network 


° permits the ACF/VTAM operator to obtain information about resources 
in parts of the network not controlled by the ACF/VTAM domain 


@ allows control of a communication controller of one host to be trans- 
ferred to another host 


° permits control of the terminals of a communication controller to be 
divided among multiple host processors 


In a VSE environment ACF/VTAM services the Communication Adapter, which is 
an optional feature of the IBM 4331 and 4321 processors. It allows the use 
of link-attached terminals without requiring a communication controller 
Cand NCP). Together, ACF/VTAM and the Communication Adapter provide the 
following functions: 
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® terminal addressing 

° terminal dialing 

° terminal polling 

° terminal answering 

° management of SDLC and BSC line controls 

« control of multi-point lines 

° exchange of identification sequences for terminals on switched lines 
° management of modem/line interface 

° pacing 

° detection, recovery and recording of temporary line errors 

The communication adapter also provides the service functions of the host, 


which are line-testing, line-tracing and configuration-updating 
functions. 


Chapter 2: SNA and ACF/VTAM V2 Overview 13 


14 


Raleigh International Systems Center 


Raleigh International Systems Center 


3.0 PREPARING THE NETNORK HARDHARE 


It is assumed that you already have determined and ordered the products 
for the physical configuration required to meet your normal operating 
needs. 

You should now check or arrange your physical as well as VSE SIPO/VE 3.1 
and ACF/VTAM installation as described in this and the next chapter. 


3.1 DOCUMENTATION OF THE CONFIGURATION 

During the arrangement of your physical configuration you should document 
the status of your installation. 

After this chapter have following information available: 

° the Customer Set Up (CSU) configuration sheets for each control unit 

e the modem specifications 

e the hard-copies of the Service Processor configuration screens 


Use the Configuration Documentation Sheet (see appendix D) to describe 
each network component. 


3.2 THE IBM 4331 SERVICE PROCESSOR 

The IBM 4331 has a Service Processor, which is used by IBM Customer Engi- 
neering for 

e maintenance activities 

e testing 

° tracing 


The Service Processor is also involved in configuration and reconfigura- 
tion of the 


® Display/Printer Adapter 
° LOOP adapter 


® Communication Adapter 


Chapter 3: Preparing the Network Hardware 15 


Raleigh International Systems Center 


You can do this in the following way: 
Press the MODE SEL key, which will display the following screen: 


XMODE SELECTION 


PROGRAM RESET DISPLAY/ALTER 

CLEAR RESET PROGRAM LOAD 

MACHINE SAVE ADDRESS COMPARE 

RESTART CHECK CONTROL 

INSTR STEP INTERVAL TIMER 

RESET I-STEP NATIVE DISPLAYS AND PRINTERS 
TOD ENABLE COMMUNICATION LINES 

LOOP ADAPTER 


p 
C 
§ 
R 
I 
N 
Y 
F 


SELECTION: 


Figure 2. The Mode Selection Screan 


Entering '‘'E*® or 'F* or 'M® will display screens for configuration and 
reconfiguration of your network. 


Use this facility also for documentation of your network by pressing the 
copy key of your system console after each display. 


Details will be shown in the following sections. 


3.3 LOCAL DEVICES 


Terminals connected to a host processor through a channel are called local 
terminals. These devices can be attached to the IBM 4331 processor viaa 
channel and control unit or directly via an I/0 adapter that functionally 
replaces a channel and control unit. The latter approach provides low-cost 
attachment of I70 devices and reduces physical space requirements. 

Local terminals can be either SNA or non-SNA terminals. 


’ 
For example, ACF/VTAM supports the following locally attached control 
units: ; 


° NON-SNA (CThese control units appear to ACF/VTAM as PU TYPE 1) 
ae IBM 3272-1,2 


= IBM 3274-1B,21B,1D,21D,31D (supported as 32/72-1,2) 
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= IBM 4331 Display/Printer Adapter (supported as 3272-2) 
e SNA (These control units appear to ACF/VTAM as PU TYPE 2) 
a IBM 3274-1A,21A,31A 
= IBM 3791 
= IBM 3730/3791 
= IBM 4331 Loop Adapter 
Display/Printer Adapter-attached Devices 
The Display/Printer Adapter is an I/0 adapter to which 1 to 8 devices can 
be attached Cor 16 with the extension feature). Port 0 must be used for 
the IBM 3278-2A or 3279-2C console. 
The devices that can be attached are : 
e IBM 3278-2A or 3279-2c Display Console Crequired) 
° IBM 3278/3273 Model 2 
° IBM 3178 
° IBM 3287 Medel 1 and 2 
° IBM 3262 Models 1 and 11 line printer Cnot supported by ACF/VTAM ) 
® IBM 3289 Model 4 Line printer (not supported by ACF/VTAM ) 
These devices may be installed in any combination except that the IBM 
3278-2A or 3279-2C console is required and ne more than 2 line printers 
CIBM 3262-1,-11 or IBM 3289-4) may be installed. 


The Display/Printer Adapter support includes most of the standard func 
tions of the IBM 3274-138 with the IBM 3278 Model 2 attached. 


Note: 
The Display/Printer Adapter appears to ACF/VTAM as a non~-SNA IBM 3272-2 
and the devices attached to it as IBM 3277 and IBM 3286. 


Physical Installation of Devices on the Display/Printer Adapter 


Physical installation of teleprocessing devices on the Display/Printer 
Adapter is simply done by connecting a coaxial cable to one of the eight 
or sixteen ports on the IBM 4331 Processor Cuser responsibility). Only the 
system console will be installed by the IBM Customer Engineer. 


The support for the DPA is given on channel 0 of the IBM 4331. Qn this 
channel 0 addresses 'O9'-'1F' are available for assignment by the user to 
devices attached via the DPA. 

The addresses of these devices are not hard wired. 
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The assignment of the device addresses is done at installation time using 
the Service Processor and can be easily examined and changed. 


Press the MODE SEL key on the system console. The MODE SELECTION screen 
will be displayed: Csee Figure 2 on page 16) 


Entering '"M*® CNATIVE DISPLAYS AND PRINTERS) will display the following 
screen: ! 


XNATIVE DISPLAYS AND PRINTERS* 
(DEVICE ADDRESS RANGE: X'009' - x'O1F") 


ATTACH DEVICES: 3278-2, 3287, 3289-4 DETACH DEVICES: KEY IN 'X' 
Oo TRANSLATE TABLES(T): TYPEWRITER CUNITED STATES) =1 
DATA ENTRY If CEBCDIC) =2 


PORT DEVICE PORT DEVICE ADR T 
00 3S77R—-2A 01 O1E X 


02 1 03 009 


04% 05 012 


06 . 07 . O13 


Figure 3. The Native Displays and Printers Screen 
® Supply for each port the device type, model number, the address (must 
be between 009 and O1F) and the appropriate translate table (T) for 
the keyboard. 
e After the last modification, press ENTER. 


e After the system answers: PRESS IML AFTER UPDATE, press the IML key 
and re-IPL. 


The actual screen layout may be different, depending on the EC level. 
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Test of Devices attached on the DPA 

If you have completed the steps above, you can check the physical arrange- 
ment of your devices. This facility is only available with certain IBM 
3270 terminals C(Ctype A). 

There is a test function, which is invoked by holding down the ALT key and 
pressing the ALT key. Now the terminal is in the TEST mode and after 
entering ‘'/*' the position of the device on the control unit as well as 
the type of the control unit C'I' for the DPA) and active features are 
displayed. | 

To leave the TEST mode, again hold down the ALT key and press the TEST key. 


Use this function also to get the values for your Configuration Documenta~ 
tion Sheet. 


Loop Adapter-attached Devices 

The Loop Adapter is an I/0 adapter with a maximum of 2 directly attached 
and 2 data link loops to which 1 to 80 devices can be attached. Each 
directly attached loop can consist of 2 lobes. | 

At least one 3843 control unit is necessary for each data link loop. 

The devices that can be attached are : 

° IBM 3641 Model 1 and 2 

e IBM 3642 Model 1 and 2 

e IBM 3643 Model 3 and 4 

° IBM 3644 

© IBM 3645 

e IBM 3646 

© IBM 3647 

° IBM 3287 Model 11 and 12 

The control units that can be attached are : 

° IBM 3274 Model 51C 

° IBM 3276 Model 11,12,13,14 


@ IBM 8775 Model 1 and 2 


These devices may be installed in any combination except that one loop may 
not have more than 64 attached devices. 
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Note: | | 
All IBM 36417/742/43/46/47s (Clocally or remotely attached) appear to 
ACF/VTAM as one local SNA PU TYPE 2. 


Each IBM 3644745, IBM 3274776, IBM 3287, IBM 8775 Clocally or remotely 
attached) is a local SNA PU TYPE 2. 


Devices on a remote loop are considered as locally attached devices. 


Physical Installation of Davices on the Loop Adapter 


Physical installation of teleprocessing devices on the Loop Adapter is 
done by connecting the device cables to the Loop Station Connectors. The 
installation of the loops is user responsibility. This is discussed in 
detail in the 


© Communication Loop Planning Guide and 
e Multiuse Communication Loop Installation Guide. 


Each device/control unit must be set up by the user. For details refer to 
the Component and Operator Description available for each device. 

During the set up process each device is given a Station address , which 
is set in the jumper box or on the screen. This address must agree with 
the station address given at the Terminal Update and Display Screen (see 
below). 


Note: 


Every time you change either this address or other configuration details, 
power off/on the device. 


Assigning Addresses of Devices on the Loop Adapter 
The support for the Loop Adapter is provided on channel 0 of the IBM 4331. 
On this channel, addresses X*'40' - X'7E*® are available for assignment by 
the user to devices attached via the Loop Adapter. 


The addresses of these devices are not hard wired. 


The assignment of the device address is done at installation time using 
the Service Processor and can be easily examined and changed. 


Press the MODE SEL key on the system console. 
The MODE SELECTION screen will be displayed (see Figure 2 on page 16). 


Entering 'F* (LOOP ADAPTER) will display the LOOP ADAPTER CONFIGURATOR 
SELECTION MENU: 
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LOOP ADAPTER CONFIGURATOR SELECTION MENU 


A TERMINAL PARAMETER DISPLAY AND UPDATE 


B LOOP PARAMETER DISPLAY AND UPDATE 


C INLINE TESTS 


SELECTION : . 


Figure 4. Loop Adapter Configurator: Selection Menu 


Entering "At will shon the Terminal Display and Update Screen: 


LOOP ADAPTER CONFIGURATOR TERMINAL DISPLAY AND UPDATE PAGE 0001 


DIRECTLY ATTACHED LOOP 1 PORT ADDR: 08 CHARACTER SET: 


STAT TERMINAL SUB LU TERM STAT TERMINAL SUB LU TERM 
ADDR CHNL ADDR PARA ADDR CHNL ADDR PARA 


01 40 01 Fl 00 


2 ® e.6° oe © oe @ 


42 XX 


e e * @ 


XX XX 


e 


XX 


DEC 143 BUFFERS AVAILABLE 


PRESS PF1l FOR BUFFER STATISTICS 


Figure 5. LA Configurator: Terminal Display and Update Screen 
Supply and check for each device: 
e Station address 
X'O1!' -— X'FE! 


This address must agree with the address given to the device during 
the set up process. This address has to be unique. 
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@ Terminal type 
e Subchannel address 


This is the address used in the ACF/VTAM PU-Macro, parameter 
CUADDR=0xx, and in the VSE ADD-command. | 


X'40° for all IBM 3641742/43/46/47 
X'41" - X*7E* for IBM 3274, IBM 3276, IBM 3287, IBM 3644, IBM 3645, 
and IBM 8775. 


® LU address 


This is the address used in the ACF/VTAM LU-Macro, parameter 
LOCADDR=xx Chere in decimal). 


X*'O1* for IBM 3287, IBM 3644, IBM 3645 
X'O02' for IBM 3274, IBM 3276, IBM 8775 
X'OL' — X*7E* for IBM 3641/492/43/46/47 
An IBM 3646 occupies 4 consecutive addresses 
© Terminal parameter 
Character set for IBM 3641, etc. 
For details refer to 
@ IBM 4331 LOOP ADAPTER Functional Characteristics 
@ IBM. 4331 LOOP ADAPTER Operating Procedures 
After the last modification, press PF3. 
You also have to check and maintain the loop specifications which are dis~- 
played in the Loop Adapter Configurator Loop Display and Update Screen. 


Invoke this panel in the following way: 


Press the MODE SEL key on the system console. 
The MODE SELECTION screen will be displayed (see Figure 2 on page 16). 


Entering '‘'F* CLOOP ADAPTER) will display the LOOP ADAPTER CONFIGURATOR 
SELECTIGCN MENU Csee Figure 4 on paga 21). 


Entering "Bt will display the Loop Display and Update Screen: 
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LOOP ADAPTER CONFIGURATOR LOOP DISPLAY AND UPDATE 


PASSWORD : x NUMBER LOOP MESSAGES : 0050 


LOBE 1 LOBE 2 PACING NR2ZI HALF MODEM PERM POLL 


ACTIVE ACTIVE T/O SPEED WRAP REQ T/0 
TO MASK 
LOOP ji Y Y X Ol SEND 
LINK 1 X 10 N N N Y xX 03 
xX oe ¢ x ® 


Figure 6. Loop Adapter Configurator: Loop Display and Update Screen 


Supply and check: 


@ 


PASSWORD 

Identification for an operator ona 3643 invoking the test function 
NUMBER OF LOOP MESSAGES 

Wraparound value between 50 and 400 

LOBE 142 ACTIVE 

Local loop split in lobes indicating which one is active 

PACING T/0 

Pacing timeout value 

X*O1L® €6.25 ms) for direct attached loops 

X*10* €100 ms) and higher for data link loops (dapending on the modem 
turn around time and line speed) 


NRZI 


Non-return-to zero-inverted method Cdepending on modem and device set 
up) 


HALF SPEED 
Modems, IBM 3843 and the data link loop attached devices must agree 
MODEM WRAP 


Specify only "Y* if you are using IBM 387X modems 
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® PERM REQ TO SEND 
"Y* for 4 wire lines, unless the modem supplier specifies otherwise 
® POLL T/0 MASK 


Should be three times the Pacing Timeout value 
i.e X*03* €300ms) 


For more details refer to 
® IBM 46331 LOOP ADAPTER Functional Characteristics 


e IBM 4331 LOOP ADAPTER Operating Procedures 


After the last modification, press PF3. 
After the system answers: PRESS IML AFTER UPDATE, press the IML key and 
re-IPL. | | 


Test of davices on the Loop Adapter 


After the application of the steps above, you may verify the physical 
installation and address assignment of devices attached to the Loop Adapt~- 
er. 

Before you start, make sure that the 

e davices are connected with the loop, 

e devices are powered on, 

e IML is performed after the last configuration changes, 

® unused loop/lobe cables are terminated with a terminator. 


Now invoke the LA INLINE TEST screen in the following way: 


Press the MODE SEL key on the system console. 
The MODE SELECTION screen will be displayed (see Figure 2 on page 16). 


Entering '‘'F' CLOOP ADAPTER) will display the LOOP ADAPTER CONFIGURATOR 
SELECTION MENU (see Figure 4 on page 21). 7 


Entering 'C* Will display the INLINE TEST screen: 
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LOOP ADAPTER INLINE TEST 


PF2: HALT TEST BEING EXECUTED 


*%*¥% PRESS PF1 TO ENTER LA TEST MODE 


Figure 7. LA Inline Test Screen 
Press the PFl key and after the normal system console layout is displayed, 
the CHG DPLY key. 
The Inline Test Screen will be displayed again and now you can enter the 


following commands, which are described in IBM 4331 Loop Adapter Operating 
Procedures: 


e 001 display loop messages. The loop €s) should be cpan, 
otherwise issue the start command. 


e 007 SAx assign test device (SA = station address) 
® 550 xx xx xx send test data 


Check the response after each command. 
For each device special test commands (e.g.A0x) are available. 


If the data transmission was successful continue with the next device 

e 007 SAx assign test device (SA = station address) 

° 550 xx xx xx send test data 

‘Do not forget to terminate the tests with the '000' command. 

These tests should complete successfully, otherwise your physical con- 


nection or address assignment 35 wrong. 


IBM 3270s attached via control units on the Loop Adapter may also be test- 
ed as described earlier in this chapter. 


Make a detailed drawing of your loop/lobe configuration (which device is 
in which position etc.). 


During one production day a lot of information will be collected in the LA 
counters. 
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The *010" command displays this information, which can used for problem 
determination. 


Channel-Attached Devices 


In addition to the DPA attachments, terminals and other I/0 devices can be 
attached by a control unit to the byte multiplex channel or the block mul- 
tiplex channel(s). 


One or more IBM 3272-1,2 or IBM 3274-1B,1D,21B,21D,31D non-SNA control 
units can be attached to the IBM 4331 Processor via a channel. 

The devices attached to these non-SNA control units have physical 
addresses which must be specified in the VSE IPL ADD statement and in the 
ACF/VTAM LOCAL macro. 


One or more IBM 3274-1A,214,31A SNA cluster controllers can be attached to 
the IBM 4331 Processor via a channel. 

Each SNA control unit with its attached devices has only one physical 
address which must be specified in the VSE IPL ADD statement and in the 
ACF/VTAM PU macro. 


Physical connection of channel attached devices is done by an IBM Customer 
Engineer, who will assign the relevant channel addresses. 


A 3274 must be customized by the customer before it can be used. This is 
done offline by responding to a series of questions presented on a screen 
attached to port 0 of the control unit. The final result is a customized 
system’ diskette which ts left in the 3274. When the 3274 is powered on, 
or IML is pressed, the customized microcode is loaded from this diskette. 
Full details on customizing the 3274 can be found in the 3274 Control Unit 


Planning, Setup, and Customizing Guide. 


If you have a 327% model 1A,1B or 1D you need know which, if any, Extended 
Function Store features are installed before you start customizing. These 
can be found on the literature accompanying the 3274. 


When customizing, select only the features that you have or require. 
When you have finished customizing the diskette, it 1s recommended that 
you create a second, backup diskette on the spare system diskette supplied 


With the 3274. 


ASSIS 


nment of Addresses of Channel attached Devices 


The determination of addresses is done by the IBM Customer Engineer. He 
Will make the addresses available which are needed for the ACF/VTAM and 
VSE dafinitions. 


On channel 0 the addresses X'24' to X'3D* and X*3F* on nonshared subchan- 
nels and X'80" to X'BF* on shared subchannels can be used. A nonshared 
subchannel is designed for the use with a control unit that has only one 
I/O device attached or that has multiple I/0 devices attached and is capa- 
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ble of using the block multiplexing facility. A shared subchannel can be 
used by a set of devices, but only one of these devices can be in operation 
at a time. There are some more restrictions on using these addresses on 
specific configurations. 


The following contain detailed information on this subject: 


y The Guide to the IBM 4331 Processor 


® IBM 433) Processor Functional Characteristics and Processor Complex 
Configuration 


The block multiplex channel can operate in selector mode, equivalent to 
the selector channels on IBM 7360 and IBM 7370 systems, or in block multi- 
plex mode equivalent to IBM 7370 block multiplex channel. The operating 
mode of the channels depends on the address specification of the attached 
devices. 


Test of Channel attached Devices 
If you have finished with the steps above, you can check the physical con- 


nection (control unit - terminal) as described with the DPA-attached 
devices. 


3.4% REMOTE DEVICES 


Terminals connected to a host processor through communications lines are 
called remote devices. In the case of an IBM 4331 processor, the communi- 
cation lines can be attached to the Communications Adapter (CA), a special 
feature integrated in the host processor and described later in this chap- 
ter. 


ACF/VTAM supports only the SDLC and BSC line control disciplines of the 
CA. There is no support for start/stop lines. 


For example, ACF/VTAM supports the following remotely attached display 
control units: 


e SDLC (These control units appear to ACF/VTAM as PU TYPE 2) 
a IBM 3271-11,12 
= IBM 3274-1C,210,31C,51C 
= IBit 3275-11,12 
— IBM 3276-11,12,13,14 


= IBM 8775-11,12 
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° BSC (These control units appear to ACF/VTAM as PU TYPE 1) 
- IBM 3271-1,2 | 
~ IBM 3274-1C,21C,31C,51¢. (supported as 3271-1,-2) 
—- IBM 3275-1,2 | 
—- IBM 3276-1,2,3,4 
Note: 


Some control units can work either in SDLC or BSC mode. This depends on 
the CSU (Customer Set Up) of these units. 


Communication Adapter-Attached Pevices 


The Communications Adapter with ACF/VTAM supports most of the functions 
provided by the IBM 3704/3705 Communications Controllers and the Network 
Control Program CNCP). As long as the network of remote devices is within 
the capabilities of the Communications Adapter, there is no need for a 
Communications Controller. 


A set of 8 addresses, from X'030' to X'037", is reserved in channel 0 of 
the IBM 4331 for the use of the CA. These addresses must be used to specify 
to DOS/VSE and ACF/VTAM the lines attached to the CA. Only one CA can be 
installed in an IBM 4331 processor. 


The line control disciplines supported by the CA are: 


° SDLC 
e BSC 
° Start/stop C€not supported by ACF/VTAM) 


The CA can be provided with one or two Autocall interfaces, which permit 
the attachment of Autocall units, optional devices that enable ACF/VTAM to 
dial a switched cluster/terminal without operator intervention. 


The CA supports only half-duplex data transmission, however, 2-wire and 
4-wire communications lines can be attached to the CA. 
Data rates of 600 to 93600 bps are supported for BSC and SDLC lines. 


One high-speed BSC or SDLC line, with a rate up to 56,000 bps, can be 
attached to the CA. This line can operate concurrently with other lines 
attached to the CA as long as the aggregate data rate does not exceed 
64,000 bps. | 

The maximum aggregate data rate that can be handled by the CA is 64,000 
bps, if permitted by the interference from other operating channels. In 
order to achieve the maximum rate, lines should be installed in order of 
dacreasing speed, with the highest speed in position 1, etc. 
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Each line also requires a modem feature for a stand-alone or an integrated 
modem (1200 bps onlyd. Clocking can be provided by the CA or by the 
stand-alone modem. 


The Local Attachment Interface provides for the local attachment of one 
BSC or SDLC terminal without the use of a modem. 


Certain specifications must be included with the order. These may be 
obtained from the Sales Manual. 


In certain IBM 4331's (depending on model, EC-level), the line control 
discipline can be changed only by ordering the necessary microcode changes 
through the MES process. 

In addition, a cable must be ordered for each adapter position. A change 
of an address may require a different cable to be ordered with MES. Cables 
are not automatically supplied. 


Refer to: IBM 4300 Installation - Physical Planning 


Physical Installation of Devices on the Communication Adapter 


Point-to-Point 


A point-to-point configuration using an analog (telephone) line is setup 
similarly to Figure 8. Note that the PU address of 'C1l’' is arbitrary, but 
the same address must be used on the PU itself. 


In this setup, the PU may have permanent Request To Send (RTS), which will 
cause permanent carrier to be generated on the line. This eliminates modem 
turn-around time at the secondary Cremote) end. Alternatively, the sec- 
ondary modem could be strapped or switched for permanent carrier. Similar- 
ly, the Communications Adapter, or the modem on the host end, can have 


permanent RTS selectad. 
© gi Ha » |— oe 
telephone line C1" 


modem modem 


Host Site Carrier Facility Remote Site 


Figure 8. Devices attached to the CA: Potnt to Point 
Multipoint 


In the case of multidropped PU's ona line, the signals ona line are sent 
to all PUs by the use of an analog splitter (see Figure 9 on page 30 ), a 
digital splitter - also known as a modem, or port, sharing unit - (see 
Figure 10 on page 30 2}, or a combination of the two (see Figure 11 on page 
30 3. The SDLC frame contains an address which determines which PU is to 
act upon which frame. The address is set in the ACF/VTAM PU macro and in 
the PU itself. 
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None of these multidropped PUs may have permanent RTS: it must be con- 
trolled RTS in each case. | | 


There are various combinations of ways of configuring the line, but the 
definitions to ACF/VTAM are exactly the same. See Chapter 5, section: 'Re- 
mote Devices’ for details on coding. 


modem 


analog 
splitting 
davice 


Figure 9. Multipoint Using an Analog Splitting Device 


modem | 

Host , i PU A 

Site ----|n : —— "C1! 

: 7 PU B 
digital "C2" 4 

splitting = 

device 

PU C 

~~ tcs' 


Figure 10. Multipoint Using a Digital Splitting Davice 


modem 


Host 
212 Sse Le Se eee ee 


analog digital 

splitting | splitting 

device device 
modem 


Figure 11. Multipoint Using Analog and Digital Splitting Devices 
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Customizing of CA-Attached 3270 Devices 

Physical connection of CA-attached devices is done by the customer. The 
address of each PU is selected by the customer and is generally ‘'Cl' fora 
single PU on a point-to-point line, or Cit, "*C2', "C3", atc. for PUS ona 
multipoint line. 


IBM 327% 


A remote 3274 must be customized by the customer before it can be used. 
This is done in the same way as for channel-attached devices. 


If you have a 3274 model 1C you need know which, if any, Extended Function 
Store features are installed before you start customizing. These can ba 
found on the literature accompanying the 3274. 

When customizing, select only the features that you have or require. 

When you have finished customizing the diskette, it is recommended that 
you create a second, backup diskette on the spare system diskette 


supplied. 


When customizing a remote 3274, there are some responses which must corre- 
spond with set up parameters in the definitions in the host. 


Question Response 
2il SCS support for 3287 printer. Enter 1 if it is used. 
215 PIUD. Enter 00000 Cunless the PU is ona switched link). 


302 SDLC addr. '40*, 'Ci', atc. as described above. This must 
correspond to the ADDR parameter on the PU definition. 


313 NRZI encoding. Corresponds to NRZI selection on the CA> 
314 Enter 0 if you have defined more than 1 PU on the line. 
331 Select 1 if the line is SDLC CVTAM GROUP macro and CA). 


342 Permanent RTS will only be provided if 1 is selected and 
1 Cpoint-to-point) in @.314 


IBM 327% 
With the 3276, options are selected through a switch panel on the unit. 
Refer to the 3276 Description and Programmer's Guide for details on 


selecting options. 


With the 8775, options are selected from the keyboard. Refer to the 8775 
Terminal User's Guide for details on selecting options. 


Chapter 3: Preparing the Network Hardware 31 


Raleigh International Systems Center 


Setting/changing Communication Adapter Line Characteristics 


When the CA is installed in an IBM 4331, a configuration table is included 
on the system diskette. It contains one entry for each installed line 
that describes the characteristics and features of the line. Certain line 
parameters, described below, can be set or changed either temporarily (by 
the operator) or permanently Cby the IBM Customer Engineer). 


The IBM Custemer Engineer can initially set or later change the following 
parameters tor 
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start/stop, BSC, and SDLC lines: 


= Select a switched line instead of a non-switched line (for 
external modems only) 


= Permanent request to send (4-wire communications line) ? 
= EIA/V35 interface card disabled Cexternal modem wrap) 

= Select standby for Switched Network Backup 

—- Integrated modem answer tone select (2100 or 2150 Hz) 
BSC and SDLC lines only: 

= New Syne 

= Data signal rate select 


_ Select high speed operation for one line only Cenables an extra 
transmission buffer for the line) 


_ DTR Cdata terminal ready) or CDSTL Cconnect dataset to line) 
_ NRZI setting Conly for SDLC lines) ° 


_ Error index byte and EBCDIC or ASCII transmission code (BSC only) 


For 2-wire lines PERM REQUEST TO SEND must be set to 'NO' 

The NRZI option must be matched between the different components of 
the network as: | 

line ~ front end modem - controller modem - controller 

They all must be set to NRZI or no-NRZI for SDLC lines. In the CA this 
is done through the Service Processor facility, in the IBM 3276 by 
setting a switch during the customer set-up process. The character- 
istics of the modem must be checked to see if it requires NRZI, and 
hor it can be jumpered to NRZI or no-NRZI. 
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Parmanent Changes 


For permanent changes the IBM Customer Engineer must use the IBM 4331 
Maintenance and Service Program Selection function which 1s invoked by 
holding down the ALT key and pressing the MODE SEL key on the system con- 
sole. 


The IBM 4331 Maintenance and Service Program Screen will be displayed. 
The user may use this procedure to make inquiries on what is specified in 


the microcode. 


The screen displayed has the following format: 


IBM 4331 MAINTENANCE AND SERVICE PROGRAM SELECTION 


LOG TEST TOOL 
0=LOG MODE 5=POWER B=MANUAL OPERATIONS 
1=REFERENCE CODE LOG 6=CENTRAL COMPLEX C=UTILITIES/REMOTE 
2=DETAILED LOG DISPLAY 7=5424 D=COMMUNICATION ADAPTER 
3=LAST DETAILED LOG 8=DISK/TAPE -=FRIEND 
-=OTHERS 9=CA INLINE F=OTHERS 


~=TEST CHAINING 


SELECTION: - = NOT AVAILABLE 


Figure 12. The Maintenance/Selection Program Screen 


Entering "D* CCOMMUNICATION ADAPTER) will display the following screen: 


XXX CA TOOLS Xxx 


A UPDATE CONFIGURATION TABLE 
B UCW DISPLAY 
C DISPLAY TRACE DATA 


**¥% ENTER SELECTION XX 


SELECTION: 


Figure 13. The CA Tools Screen 
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Entering "A' will display the CA CONFIGURATION DATA Screen. 


The CA Configuration Data Screen will display a description of the fea- 
tures of each line: 


*x¥% CA CONFIGURATION DATA Xxx 


PFI-ADVANCE LINE POINTER PF4~-SELECT NEXT CA LINE ADR 
PF2-SELECT NEXT OPTION ENTER-UPDATE AND EXIT 
PF3-EXIT WITHOUT UPDATE 


LINE ADDRESS 30 BSC MOD CLOCK EIA I/F 


===>SWITCHED NETWORK YES =>NO 
PERM REQUEST TO SEND YES =>NO 
WRAP TEST SELECTION MODEM =>CA I/F 
SELECT STANDBY YES =>NO 
MODEM ANSWER TONE CHZ) 2025 2100 
NEW SYNC YES =>NO 
EIB MODE YES =>NO 
DATA SIGNAL RATE SEL LOW =>HIGH 
HIGH SPEED OPERATION YES NO 
MODEM PROCEDURE CDSTL =>DTR 
DATA CODE ASCII =>EBCDIC 


Figure 14. The CA Configuration Data Screen BSC Lines 
This screen displays the configuration table of line 030 which is a BSC 
line with modem clocking and EIA I/F adapter type. With a certain EC-level 
of the IBM 4331 the line control can be changed in the corresponding 
field. 


The features can be changed as described after the next screen. 


To display the configuration data of the next CA line, press PF4¢. 
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%*% CA CONFIGURATION DATA Xxx 


PF1-ADVANCE LINE POINTER PF4-SELECT NEXT CA LINE ADR 
PF2-SELECT NEXT OPTION ENTER-UPDATE AND EXIT 
PF3-EXIT WITHOUT UPDATE 


LINE ADDRESS 31 SDLC MOD CLOCK EIA I/F 


===>SWITCHED NETWORK YES =>NO 
PERM REQUEST TO SEND =>YES NO 
WRAP TEST SELECTION MODEM =>CA I/F 
SELECT STANDBY YES =>NO 
MODEM ANSWER TONE CH2Z) 2025 2100 
NEW SYNC YES =>N0 
NRZI =>YES NO 
DATA SIGNAL RATE SEL LOW =>HIGH 
HIGH SPEED OPERATION YES NO 
MODEM PROCEDURE CDSTL =>DTR 


Figure 15. The CA Configuration Data Screen SDLC Lines 


This line (031) is a SDLC line with modem clocking and EIA I/F adapter 
type. 


The user can update a given parameter using the following procedure: 


° Use the PF1 key to put the large arrow in front of parameter to be 
updated. 


e Use the PF2 key to put the small arrow in front of the desired value. 


If you want to update the diskette with a new configuration table hit 
ENTER, and a warning message will appear. Hit ENTER again, and the disk- 
ette will be updated. If you do not want to update the diskette exit with 
PF3. 


Normally, updating of the configuration table will be done by the IBM Cus- 
tomer Engineer. After the IBM Customer Engineer has made changes in the 
configuration table, an IML will have to be performed for the changes to 
take effect. 


Where connection problems occur, check the values for PERM REQUEST TO 
SEND, NEW SYNC, NRZI, and DATA SIGNAL RATE SEL and compare them with the 
modem specifications, the modem strapping, and the ACF/VTAM line defi- 
nition. 
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Temporary Changes 


The following configuration parameters for an individual line can be spec- 
ified by the operator: 


® Select standby for Start/stop, BSC, or SDLC lines 

® Data signal rate select 

e NRZI mode for SDLC lines 

@ Half-speed operation for BSC lines 

® ASCII or EBCDIC for BSC lines 

Where connection errors occur, the operator can change certain parameters 
for each individual line before transmission occurs or during trans- 
mission. Such changes override the parameters specified for the line in 
the configuration table but are effective only until a system reset, IPL, 


or IML 1s performed. 


The user may want to change temporarily, i.e. between two IPLs, one or 
more parameters of a specific line. To do this, 


press the MODE SEL key on the system console (see Figure 2 on page 16). 
The MODE SELECTION screen will be displayed: 
Enter "E* CCOMMUNICATION LINES). 


The following screen will be displayed: 


**¥*% CA-CUSTOMER MANUAL OP'S Xxx 


A TEMPORARY CONFIGURATION CHANGE FACILITY 
B TRIBUTARY STATION ADDRESSCES) FOR BSC LINES 


¥¥* ENTER SELECTION x 


SELECTION: 


Figure 16. The CA-Customer Manual Op's Screen 


Enter 'A'. The following screen will be displayed for a BSC lina: 
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%%% TEMPORARY CONFIGURATION CHANGE FACILITY Xxx 


PF1-ADVANCE SELECTION POINTER PF4-SELECT NEXT CA LINE 
PF2-SELECT ALTERNATE OPTION ENTER - UPDATE AND EXIT 
PF3-EXIT WITHOUT UPDATE 


LINE ADDRESS 30 BSC MOD CLOCK EIA I/F 


Vv 


===> SELECT STANDBY YES 
DATA SIGNAL RATE SEL LOW 
DATA CODE ASCII 
EIB MODE YES 


NO 
HIGH 
EBCDIC 
NO 


V 


ou tt oi 
Vv 


Vv 


Figure 17. The Configuration Change Facility Screen for BSC Lines 


The following screen will be displayed for an SDLC line: 


*¥% TEMPORARY CONFIGURATION CHANGE FACILITY Xxx 
PFI-ADVANCE SELECTION POINTER PF4-SELECT NEXT CA LINE 
PF2-SELECT ALTERNATE OPTION ENTER - UPDATE AND EXIT 
PF3-EXIT WITHOUT UPDATE 


LINE ADDRESS 31 SDLC MOD CLOCK ETA I/F 


===> SELECT STANDBY YES => NO 
DATA SIGNAL RATE SEL LOW => HIGH 
NRZI =>YES NO 


Figure 18. The Configuration Change Facility Screen for SDLC Lines 
Change the desired values as described in Figure 15 on page 35 
Figure 19 on page 38 shows where certain matching network options have to 


be defined or set. The PU 3274 column shows question numbers of the cus- 
tomization process. 
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ACFE/VTAM Remote 


Modem 


'Communic. 
Adapter 


NR2ZI 
CSDLC) | 


iserial 
number 


SDLC PU 
address 


PU macro 
ADDR= 


BSC poll !|CLUSTER mac 
address GPOLL= 


Protocol !GROUP macro 


IDNUM=id 
IDBLK=puid 


Switched] select switched | 
Line switched modem modam 
Defns. required required 


Figure 19. Network Option Selection 


Notes: 


NRZI must be yes or no for both ends. Some modems are sensitive to NRZI bit 


st 
To 


reams ~ check with the manufacturer of the modem. 


select permanent RTS, a 4-wire connection is required. RTS can be 


selected by either the DTE Chost or controller) or by the DCE (modems), 


but should not be selected by both. It can be selected for one end, both 


ends or neither end. 


Test of Remote Devices 


If 


nection (Ccontrol unit ~- terminal) as described with the DPA-attached 


you have finished with the steps above, you can check the physical con- 


devices. 
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4.0 INSTALLATION OF ACF/VTAM V2 


It is assumed that the reader is familiar with SIPO/E 3.1 and 
has the SIPO/E 3.1 manuals available. 


This chapter describes preparation and the installation of ACF/VTAM. 
@ during System Initialization of SIPO/E 3.1 (for First Time Users) 


e on top of a running SIPOZE 3.1 system as a non~-SIPO/E Program Product 


G1 INSTALLATION DURING SIPO/E 3.1 SYSTEM INITIALIZATION 


Have the SIPO/E 3.1 Program Directory and Reference Manual available. 
Check following ACF/VTAM related Systam Initialization steps in the Pro- 
gram Directory and note the changes and hints mentioned below before you 
start with the real System Initialization. 


Step 1: Select IPL Procedure 


Select the IPL and JCL procedures depending on the anvironment. Make sure 
that the selected IPL procedure has an ADD xxx,3277 statement for a 
non-SNA terminal which is physically available. 

If not, you have to ADD this device during IPL as described below. 


If an IBM 3274-1A is the only local control unit, you have to add this SNA 
control unit with an ADD xxx,3791L statament during IPL. 


This address is also used in step 19, System Initialization. 
If you have to add a device IPL -*VSE as follows: 
IPL=SIPLxxx, JCL=SSJCLxxx,STOP=ADD 


When the system anters the WAIT state, you can add those devices which are 
not contained in the selected IPL procedure with: 


ADD xxx,3277 for a non-SNA terminal Ce.g. DPA-~attached) 
ADD xxx, 3791L for an SNA control unit Ce.g. IBM 3274-148) 


2S 


Steps 12/13: Rastore the 


Previous/Current Release IPF Tar 
With these steps the SAMPLIB will be loaded. Use these SIPO/E provided 


jobs to customize your ACF/VTAM and CICS/VS environment as recommended in 
the following chapters. 
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The names of these ACF/VTAM related jobs are shown in the SIPO/E 3.1 Ref- 
erence Manual on page 162 as well as at the end of this chapter. 


Step 17: Create User Libraries 


With job "'nSETUP*® Ccorresponding to your DASD type) the User Library One 
Set is created, and the following ACF/VTAM B.books will be catalogued: 


ATCSTROO (start options) 
ATCSTR33 (start options) 
ATCCON33. = Cconfiguration list) 
APPCON33 Capplication major node) 


PATHI (path table) 


This job is listed in the SIPO/E Reference Manual Chapter: 'SIPO/E Sup- 
plied VSE/POWNER Job Streams’. 
These definitions are also used during the first ACF/VTAM start. 


During the System Initialization you release one of thea 'nVTMINST" jobs in 
the reader queue (corresponding to your DASD type) and mount the ACF/VTAM 
tape to install the product in USRCLI. 


This job installs a skeleton ACF/VTAM in order to use the initial CICS/VS 
system. This skeleton provides support for the ‘one local screen’ version 
of CICS/VS. ACF/VTAM must be re-installed later as an non-SIPO/E 3.1 pro- 
gram product to provide full configuration support. This will be done via 
the Interactive Productivity Facility CIPF) and is shown in the next sec~ 
tion of this chapter. 


To define this single local screen to ACF/VTAM the user must catalog the 
definitions of the screen in a USRSLI] as a B.book. 


The job ISTARTUP performs the creation and catalog function. Release this | 
job as mentioned in step 19. Then you will be prompted to define this 
screen. 

Valid responses for 'CU (Control Unit) TYPE AND MODEL* are: 

327202 for an IBM 3272-2. local non-SNA control unit 

4300DA for the Display Printer Adapter 

32741B for an IBM 3274-1B local non-SNA control unit 

32741D for an IBM 3274-1D local non-SNA control unit 

327414 for an IBM 3274-1A local SNA control unit 

Valid responses for ‘CONTROL UNIT 7 TERMINAL ADDRESS' are: 


e.g. '010' for an IBM 3277 attached to the DPA 
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Beware that this address is added at IPL time (refer to step 1) and that 
you have entered the corresponding control unit type Cin this case 
"4300DA') in the previous response. 
After this job has finished a major node named ‘ICCF3270'" is cataloged and 
will be used during ACF/VTAM start. 


Step 20: Starting ACF/VTAM | 


You can use the job 'VTAMSTRT’' to start ACF/VTAM. 
After releasing this job during System Initialization the following mes- 
sage will appear on the console: 


ENTER VTAM START PARAMETERS 
Type in: xx LIST=33 


When the following messages appear on the console, the local screen 
defined on the IPL Procedure will be controlled by ACF/VTAM: 


5E48I BUFFER POOL START OPTION INPUT FOR AN UNUSED POOL - IGNORED* 

5A171I UNABLE TO LOAD PHASE ISTEXCVRS 

5A17I UNABLE TO LOAD PHASE ISTSDCOS5 

5FO00I NO TRFILE AVAILABLE - WRAP MODE-TRACE ONLY 

5DI5I VTAM INTERNAL TRACE ACTIVE - MODE = INT, SIZE = 002, OPTIONS = API 
PIU MSG 

5A93I APPCON33 ACTIVE® 

5A93I ICCF3270 ACTIVE® 7 

5D4¢2I SLU D72L301 TYPE = LOGICAL UNIT , ACTIV. ,CUA=010? 

SA2Z0I VTIAM INITIALIZATION COMPLETE 


The user should now display the active nodes with following ACF/VTAM com- 
mands: | 


D NET,MAJNODES Cdisplay major nodes) 


5D50I VIAM DISPLAY - DOMAIN TYPE = MAJOR NODES 
5A89T APPCON3S3 TYPE = APPL SEGMENT » ACTIV 
5SA89T ICCF3270 TYPE = LCL 3270 MAJ NODE, ACTIV 
5D14I END 


The user may now display the minor nodes with following ACF/VTAM commands: 


D NET,APPLS (display application major nodes) 


_ This message shows that the SIPO/E default start options for ACF/VTAME 
CATCSTR33) contain buffer pool definitions which are not used any lon- 
ger in ACF/VTAM. The start options will be changed later to reflect 
the ACF/VTAM buffers. 

5 This message names a missing load phase, which 1s not necessary in 
your current environment. 

¢ The named ACF/VTAM major nodes (SIPO/E defaults) became active, and 
their minor nodes should be displayed by ACF/VTAM commands. 
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5D50I VTAM DISPLAY - DOMAIN TYPE = APPL MAJ NODES/NAMES 
5A89T APPCON3S3. TYPE = APPL SEGMENT » ACTIV. 

5A80I DBDCCICS CONCT 

5D14I END 


D NET, ID=ICCF3270,E 
or 

D NET,TERMS,E Cdisplay local non-SNA minor nodes) 

5D50I VTAM DISPLAY - DOMAIN TYPE = LOGICAL UNITS/TERMS 

5D54I PU T475 MAJOR NODE = ISTPUS 

5D51I LOCAL 3270 MAJOR NODE = ICCF3270 


5A89I D72L301 TYPE = LOGICAL UNIT 
5D14I END 


» ACTIV »CUA=010? 


The user may display the status of the ACF/VTAM buffers with the following 
command, but there should not be a buffer problem. 


D NET,BFRUSE 


Cdisplay ACF/VTAM buffers) 


5D50I VTAM DISPLAY - DOMAIN TYPE = BUFFER POOL DATA 

5G32I BUFF BUFF CURR CURR MAX MAX TIMES EXP/CONT EXP 
5G33I ID SIZE TOTAL AVAIL TOTAL USED EXP THRESHOLD INCR 
5D56I VF 02048 OO005P 00001P N/A O0004P NZA N/A N/A 
5D56I VP 02048 00170P 00138P N7A O0038P NZA N7A N/A 
5D56I SF 00356 00153 00150 60153 00003 00000 O00021/---- 00005 
5D561 LF 00183 00138 00138 00158 00006 00000 00019/---- 00010 
5D56I SP 00112 00210 00210 00210 00000 00000 00021/---- 00017 
5D56I LP 01016 00054 00050 00054 00006 00000 00007/---- 00002 
5D56I WP 00160 00100 00098 00100 00002 00000 O0011/---- 00012 
5SF95I IRNLIMIT = NOLIMIT, CURRENT = 000000K, MAXIMUN = 000000k 
5D14I END 


Step 20: Starting VSE/ICCF with CICS/VS 


During the System Initialization you release one of the 'nICFCVEC® or 
"nICFCVEF® jobs in the reader queue (corresponding to your DASD type and 
MODE) to start CICS/VS. | 


When the message 


DFH1500 CONTROL IS BEING GIVEN TO CICS 


appears on the console, the local screen will be controlled by CICS/VS. 


Step 26: LOGON to VSE/ICCF and the IPF 


To logon to ICCF, 


was defined in step 1 and 19. 


this step should be carried out at the terminal which 


Pressing the CLEAR key will erase the CICS/VS Good Morning Message. 


7 The actual CUA address 1s configuration dependent. . 
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After the LOGON sequence you are ready to work with ICCF/IPF to tailor and 
customize your system as described in the SIPO/E 3.1 manuals. 


4.2 ADDITIONAL HINTS 


LOGOFF from VSE/ICCF and CICS/VS5S 

If the terminal is in the Command Mode of ICCF, the user can leave the ICCF 
environment with the /LOGOFF command. The terminal is than logged off 
from ICCF but still connected to CICS/VS. 

To log off from CICS/VS the command CSSF LOGOFF must be used. After this 
command is entered and accepted a message is received from CICS/VS indi- 
cating that the session is terminated. 

Hitting the SYSRE@ key will display the CICS/VS Good Morning message. The 
terminal will again be connected to CICS/VS. 

Shut Donn CICS/VS 

To shut down CICS/VS enter from console: 

/TC 

and the following message will appear on the console: 

K103I ENTER TERMINAL CONTROL CCICS) OPERATOR COMMAND 

Enter: CSMT SHUT,NO 


Then the following messages are displayed on the system console: 


DFH1701 C.1.€.S. IS BEING TERMINATED 
DFH1799 TERMINATION OF CICS/VS IS COMPLETE 


Shut Down ACE/VTAM 

To shut down ACF/VTAM enter: 

Z NET,QUICK 

QUICK specifies that you want the network to be closed down immediately. 
Application programs not currently using ACF/VTAM are denied access to 
ACF/VTAM. 


Recommendations 


When you start your System Initialization have the SIPO/E 3.1 Eepgram 
Directory and this document at the system console. 
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During IPF's FIRST TIME USE allocate library set 'G', as it is recom 
mended that you install ACF/VTAM in library set 'G'. 
6.3 SIPO/E 3.1 ASSISTANCE FOR NETNORK DEFINITIONS 
After the System Initialization steps of the SIPO/VE 3.1 (see above) you 


will find several ACF/VTAM related jobs in ICCF-Lib 59 CSAMPLIB). 


Member VTAMBOGK contains definitions for a: 


Start list ATCSTROO/ZATCSTR3I3 
Configuration list ATCCON33 
Path definition PATHL 


Local non-SNA major node ICCF3270 
Mamber VTMSTRT contains an ACF/VTAM start job. 


Member USSTAB contains a job which catalogs an Unformatted System Services 
table. 


If you are a First Time User or a former BTAM-ES user, you may: 
® copy these jobs to your ADMINISTRATOR-Lib, 

° rename these jobs according to your naming conventions, 

° print these jobs, and 

° modify these jobs as mentioned in the following chapters. 


Divide member VTAMBOOK into several members. Each B.book should be repres~- 
| ented ina separate CATAL job and member. 


There are also CICS/VS related jobs in this library. 


Member DFHSIT contains a SIT catalog job. 

Member DFHPPT contains a PPT catalog job which includes 
the necessary ACF/VTAM entries. 

Member DFHPCT contains a PCT catalog job which includes 
the necessary ACF/VTAM entries. 

Member DFHTCT$O contains a TCT catalog job for a CICS/VS 
with ACF/VTAM. 


You may use these jobs and modify them as mentioned in Chapter 5,6 or 93 of 
this Primer. 


Another possibility is to punch Cwith SSERV) from PRDSLB sublib 'G’ fol- 
lowing CICS/VS tables: | 


DFHSITSO, DFHPCTAS, DFHPPTAS and DFHTCTSO, 
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tables by the ICCF command 


/GETP jobname MEM=tablename Ce.g. SITxxCAT) 


into your ADMINISTRATOR Lib. 
Choose the member name as SITSVCAT and the table suffix as 'SV' ina sin- 
gle system environment. 

In a multi system environment substitute 'SV' by the subarea number. 


After job execution include these 


You may use these tables as mentioned in Chapter 5/6 or Chapter 9 of this 
primer. 


First Time Users may select from the VSE/POWER-SYSIN tape the CICS/VS-VTAM 


start job with following jobstream: 


* $$ JOB SELECT 


7/7 JOB SELECT 


* $$ PUN DISP=K,CLASS=Q 
// ASSGN SYS004,tapeunit 
// ASSGN SYS605,SYSPCH 
// EXEC OBJMAINT 
-/SELECT xICFCVEF 

-/COPY 


7% 
7% 


* $$ EOJ 


Include the output of this job into your ADMINISTRATOR Lib with the /GETP 
command. 


There are also NCCF/NPDA related jobs in this library. 


Member 
Member 
Member 
Member 
Member 
Member 
Member 
Member 
Member 


Member 
Member 
Member 
Member 
Mamber 


DSICMD 
DSIDMN 
DSIOPF 
LOGREF 
NCCFCLU 


NCCFLTAB 
NCCFVLST 


NCCFVSP 
PROFS YS 


NPDABNH 
NPDACLU 
NPDAIST 
NPDAVSP 
NPDAVSP 


You may: 


defines the NCCF commands. 

defines the NCCF domain. 

defines NCCF operators. 

defines the NCCF log task. 

creates the NCCF log data sets. 

contains the catalog job for the NCCF Logon mode table. 
defines NCCF to ACF/VTAM. 

defines the VSAM space for NCCF. 

defines NCCF operator profiles 


defines NPDA. 

creates the NPDA data bases. 

creates the ACF/VTAM CNM interface table. 
creates the VSAM space for NPDA 

creates the VSAM space for NPDA 


° copy these jobs to your ADMINISTRATOR-Lib, 


® rename these jobs according to your naming conventions, 
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e print these jobs, and 
e modify these jobs as mentioned in the Chapter lil. 
There is also SIPO/E 3.1 assistance in defining your OCCF environment. Use 


the IPF VERIFY dialog for this component as mentioned in Chapter 11 of 
this primer. : 


4.4 INSTALLATION AS A NON-SIPOZE 3.1 PROGRAM PRODUCT 


After the application of the steps described below, ACF/VTAM is installed 
and can be maintained via the IPF Service Dialogs. 


Decide on Library Set to contain ACF/VTAM 
To allow an easy testing of the new ACF/VTAM the component should be 


installed in the SIPO/E library set "G’. This library set normally con- 
tains "Non-SIPO/E Program Products’. 


Check for Service required 


At this time (March 83) no fixes need be applied before installation of 
ACF/VTAM Version 2. 


The following fixes are required after installation of ACF/VTAM Version 2: 


PREREQUISITE PRODUCT | USERS 


———— | DESCRIPTION AFFECT. 
PTF APAR INVOLVED | 


~—6dDDY29804] VSE/AF R3| DY29804 is a required VSE/AF APAR| VSE/AF 
which is a corequisite of an 
ACF/VTAM APAR which is fixed in 
this Release. A ZAP for this APAR 
is available in RETAIN 


Downstream Load Utility users 
must run on Rel. 1 maintenance 
level 2 of the DSLU 


Figure 20. APARSs, Fixes required after Installation of ACF/VTAM 


Note: | 
Use the IPF Service Dialogs toe install the necessary APARs. Also refar 


to: VSE/ZAF Maintain System History Program (MSHP) User's Guida if neces- 


sary. . 
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Prepare Installation Jobs via IPF 


To follow the SIPO/E installation procedures the IPF dialogs for installa- 
tion of '"'non-SIPO/E Program Products' should be used to create the 
installation job-streams. 


The following sequence of dialogs describes the generation of the instal- 
lation job-~stream via VSE/ICCF or VM/CMS. 


Step 1: 


Enter "aIPF* 
Enter '"=SYMS$'t, if this panel is not already displayed 


Step 2: Panel SYMS: Select '4* CINSTALLATION GUIDE) 
Step 3: Panel SYM$I1: Select '1" CNON SYSTEM IPO/E PRODUCT) 
Step 4: Panel SYMSI2: Select '1' CADD SOFTWARE PRODUCT) 


Step 5: Panel ADMSSFNI1: | 


COMPONENT NUMBER: ==> 5666 ==> 23 ==> 901 
COMPONENT LEVEL CODE: E27 

FEATURE: NO 

DELETE: blank 

CONTINUE: YES 


Step 6: Panel ADMSSFN2: 


NAME: ==> ACF/VTAM ==> VERSION ==> 2 
PRODUCT NUMBER: ==> 5666 ==> 280 
MULTIPLE COMPONENTS: NO 

LIBRARY SET: G 

UNIQUE STRING: VT2 

RELEASE NUMBER: 1.0 


Step 7: Panel ADMSSFN3: 


INSTALLED: NO 
VSE/ICCF members: NO 
NUMBER OF FILES: 5 
COPYR STATEMENTS: NO 
COPYS STATEMENTS: YES 
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Step 8: Panel ADMSSFN4¢ 


BLOCK TYPE: FBA (Cor User DASD Type)? 
CORE IMAGE LIBRARY: 3800 

RELOCATABLE LIBRARY: 8600 

SOURCE STMT LIBRARY: 2600 


The library allocation requirements in cylinders (CKD) or blocks (CFBA) and 
the directory. sizes in tracks (CKD) or blocks (FBA) are given below by 
device type: 


Lib/Dir 
relocat 


Lib/Dir 
core im 


Lib. Aux. 
Hist. File 


ran [saooves 8600745 2600/11 


Figure 21. Library Space Requirements for ACF/VTAM 
Step 9: Panel ADMSSFN1: CONTINUE: NO 
Step 10: Panel ADMSSFT5: Hit ENTER key 
Step 11: Panel SYM$I2: Select '2" (CONTINUE) 


Step 12: Panel SYMSI3: Select '1' CCREATE COPY FILES) 


Note: 

For installation of non-SIPO/E Program Products, IPF assists in generat- 
ing the necessary job control to merge members from the service to the 
production library. 


The next three steps assist in creation of the necessary table containing 
the member names to be merged. The table is stored under the name 


INSSVT2S Cunique product string plus 'S' for SL) in non-compressed format 
in the user's primary library Cin most cases library 1). 


6 for other device types see Figure 21 
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Step 13: Panel ADMSCPY1: 


PRODUCT STRING: VT2 
RELOCATABLE: NO 
SOURCE STATEMENT: YES 
EXIT: NO 


Step 14: Panel ADMSCPY4: 


SUBLIBRARY: E 

CONTINUE: YES 

==> COS ==> COSEND ==> COSTAB ==> ISTRH 
==> ISTBLENT ==> ISTGLBAL ==> == > 


Step 15: Panel ADMSCPY4: 
SUBLIBRARY: 2 


CONTINUE: NO 
==> ISTINCNO ==> 


if 
iT 
Vv 
if 
if 
Vv 


Step 16: Panel SYMSI3: select '2' 


Step 17: Panel SYMSI5: 


To add or update Library set definitions: Select '2" CIBM PRODUCTION 
LIBRARIES) 


To continue with step number 18 (Panel SYMSI6): Select '"5’ 


Step 18: Panel SYMSI6: 
Select '2' (CONTINUE) if no ASI tailoring is required 


otherwise, if library set 'G* has been just added or moved to a different 
volume: | 


Select '1*° CASI Tailoring) 
Leave after panel TASSMAS2 with generation of jobstream 


Select '2" (CONTINUE) on panel SYMSI6 


Step 19: Panel SYMSI7: Select 'ICCF’ by pressing PFK 4. 
Now create the IPF COPYS file for the ACF/VTAM installation job stream. 


Decompress the existing IPF COPYS table INSSVTMS CACF/VTAM R. 3.0) and 
include it into the new COPYS table INSSVT2S (CACF/VTAM V2) by. entering: 
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*IPFDCMP INSSVTMS* 
"QED INSSVT2S' 
"GET INSSVTMS* 
SFILE* 

TOIPF' 


Note: 
For a detailed description of the SIPO/E procedures for decompressing and 
compressing refer to the IPE User's Guide. 


The new table INSSVT25 will be automatically picked up during generation 
of the installation job stream and the necessary COPYS statements will be 
included. 


STEP 20: Cback on Panel SYM$I7): Select "1" CCONTINUE) 


Users with IBM 3641/42/44/46/47 may continue with the installation of the 
CICS/VS PRPQ (5799-BEH). 


Users with IBM 3644 may install GEN3644 (5668-9938) now. 


Users with IBM 3644 and/or IBM 8775 (with feature 3624/26, 5110) may con- 
tinue with the installation of DSLU €5668-006). 


Tha dialogs for installing these non~-SIPO/E Program Products into the Pro- 
duction Library Set G are nearly the same as described for the ACF/VTAM 
installation. 


After this dialog check the generated VSE/POWER job via ICCF. 
You may remove the job sequence which copies the S$SRASTxx phases into VSE 
System Core Image Library. This is not necessary with ACF/VTAM. 


Notes for former ACF/VTANE or ACF/VTAM Release 3.0 users: 
Users with sa running ACF/VTAME or ACF/VTAM Release 3.0 must delete this 
job sequence, otherwise the existing ACF/VTAM will fail. 


Submit the generated and modified installation job stream. ACF/VTAM will 
be installed in the library set 'G' and can be maintained by the IPF dia- 
logs. PTFs and APARs are only effective if ACF/VTAM is deleted from the 
USRCL1. 


Remember to check the LIBDEF definitions of your ACF/VTAM partition and 
the CICS/VS partition as well as other partitions containing ACF/VTAM 
application programs. This is of special importance if ACF/VTAME is still 
installed in library set 'C'., 


Note that PRDXLG has to be in front of PRDXxLC! 
Also check all ACF/VTAM related jobs in your environment. 
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5.0 SINGLE SYSTEM ENVIRONMENT 


It is assumed that the user has an IBM 4331 with locally and remotely 
attached IBM 3270s and IBM 364Xs. CICS/VS is the ACF/VTAM application. 


This chapter contains information about: 
e the definition of terminals attached to 
- the Display/Printer Adapter (DPA), 
= the LOOP Adapter, 
~ the channels, 
—- the Communication Adapter (CA) 
in DOS/VSE, ACF/VTAM and CICS/VS; 
e the ACF/VTAM start options, 
° the session establishment between ACF/VTAM and these terminals, 
° the definition of CICS/VS as an ACF/VTAM application, 


e and the verification of the installation. 
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5.1 PREREQUISITES TO THIS CHAPTER 


5.1.1 Hardware 


It is recommended that the set up for the CPU, the attached terminals, 
control units and modems be completed. The hardware tests should have 
been performed. | 

Have the Configuration Documentation Sheet available as described in 
Chapter 3. 


5.1.2 Software 


The installation of SIPO/E 3.1 and ACF/VTAM is completed as described in 
Chapter ¢. It is assumed that: 


Users of IBM 3641742/44/46/747's have installed the CICS/VS PRP 
(5799-BEH). 


Users of IBM 3644's have installed GEN3644 (5668-998). 


Users of IBM 3644's and/or IBM 8775 (with feature 3624/26 5110) have 
installed DSLU (5668-006). | 


First Time Users have copied all ACF/VTAM definitions from the SIPO/E 3.1 
SAMPLIB to the ADMINISTRATOR-LIB. 

Also the CICS/VS-VTAM tables have been copied either from PRDSLB or from 
the SAMPLIB to this ICCF-LIB. 


5.1.3 Network Addressing Considerations 


A network address is a sixteen bit field consisting of a subarea field and 
an element field. The number of bits allocated to each is determined by 
the ACF/VTAM MAXSUBA start option. This specifies the maximum address of a 
subarea in the network, a subarea being a host processor or a4 communi-~ 
cation controller. | 


The default is 15; the minimum is 3 and the maximum is 255. 


In a single systems environment, it is reasonable to allow MAXSUBA to 
default to 15, as this allows for enough subareas in one domain. In addi- 
tion, when an ACF/VTAM trace is done, the four bits allocated to the sub- 
area will form a hex digit, and the remaining twelve bits allocated to the 
element will form three hex digits for easy identification. 
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5.1.4 Naming Conventions 


Before you start with any ACF/VTAM or CICS/VS definitions you should 
choose your naming convention. There are several conventions to choose 
from and some examples are provided in Appendix B of this manual. 


5.1.5 Session Initialization 


A session is started with a request by a logical unit to be put in session 
With an application program. Alternatively, the application program may 
issue the request on behalf of the LU. This request is called a logon. 


Four types of logon are possible, and you should choose which type(s) you 
Will use in your environment: 


° Secondary logical unit (SLU) initiated, 
where the secondary logical unit (terminal) issues a request that 
causes it to be logged on to the selected application program. This 
is done by, for example, entering: 


LOGON APPLIDCDBDCCICS) 


at a terminal which is in the SSCP-LU session Ci.e. which has been 
activated by ACF/VTAM. 


° Application program initiated, 
where an application program (CICS/VS,for example) simulates a logon, 
as if it were coming from a secondary logical unit. For example if 
CONNECT=AUTO is coded in a TCT TYPE=TERMINAL macro in CICS/VS a simu- 
lated logon will be issued by CICS/VS for the logical unit related to 
the terminal defined in the TCT. In this case the secondary logical 
unit must ke powered on, otherwise CICS/VS sets this terminal OUT OF 
_ SERVICE. 


Do not use CONNECT=AUTO and LOGAPPL=DBDCCICS together (see below). 


© Automatic logon, 
where ACF/VTAM automatically logs a secondary logical unit on to an 
application program, indicated by coding, for example, 
LOGAPPL=DBDCCICS in the ACF/VTAM LU definition statement. 


Gperator logon, 

where the operator can cause a specified logical unit to be logged on 
to a specified application program. This is done by, for example, 
entering : 


V NET,ACT,ID=lu-name, LOGON=DBDCCICS 


at the system console. 
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Recommendations for LU-LU Session Initialization ~ 
If you have one CICS/VS system use the automatic logon technique. 


If you intend to have more than one CICS/VS running at the same time with 
the capability to access either DBDCCICS or TESTCICS from a terminal use 
the SLU initiated technique. 


If you supply an USSTAB (Unformatted System Service Table), it will allow 
the user to enter a single word to LOGON to a desired application (e.g. 
DBDcCICS, CIcs, TEST, etce.). This is useful if more than one application 
is accessed from one terminal and you are not using an automatic logon 
CLOGAPPL statement). 


To create this table refer to Chapter 6,» section "User Defined ACF/VTAM 
Tables’. 


In order to establish an LU-LU session ACF/VTAM needs to have access to a 
set of session parameters which will govern the session. 

In a CICS/VS environment these parameters are derived from parameters 
Ca.g. RUSIZE,etc. ..) in the CICS TCT macro TYPE=TERMINAL. Therefora, 
there is no need to use or code a VTAM LOGMODE table entry. 


Recommendations for the Usage of a MODETAR 


Exceptional cases, however, might require the use of a LOGMODE table entry 
for CICS sessions. The same applies for the use of other ACF/VTAM applica- 
tion programs, such as NCCF. 


This is described in Chapter 6, section: Session Parameters and section: 
VTAM Tables. 


5.1.7 Session Termination 


When one session partner decides to terminate the communication, it can 
request a session termination. The method by which this is done varies 
according to which end of the session wants to terminate it. 


Three types of session termination are possible, depending on the source 


of the termination request. Decide which type(s) you will use in your 
eanvironment. 
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® SLU requested session termination, 

where the secondary logical unit (Cterminal) issues a termination 
request that causes it to be logged off from the application program. 
Session termination is requested from SLUs if it sends the LOGOFF com-~- 
mand. To be able to enter a character-coded LOGOFF command, this ter- 
minal has to be in the SSCP-LU session. This is achieved by hitting 
the SYSREQ key on an SNA terminal (not possible on a non-SNA 
terminal). 


The LOGOFF command can have parameters to indicate to ACF/VTAM whether the 
request is for conditional or unconditional termination of the session. 


If conditional termination is requested, ACF/VTAM notifies the applica- 
tion program that the secondary logical unit has requested that the ses- 
sion be terminated. The application program can ignore the request or 
issue a CLSDST macro instruction to terminate the session. 


If unconditional session termination is specified, ACF/VTAM terminates 
the session and then notifies the application program that the session has 
been terminated and that it is to issue a CLSDST macro instruction. 


The format of the LOGOFF command is: 
LOGOFF <APPLID{Capplname)> <TYPECCOND|UNCOND|FORCE)> <HOLDCYES|NO)> 
The parameters included between < > are optional. 


APPLIDCapplname) ==> Specifies the name of the application program with 
which a session is to be terminated Coptional) 


TYPECCOND|UNCOND| FORCE) 
==> Specifies the type of LOGOFF as conditional or 
unconditional or forced. 
The default value is unconditional. 


HOLDCYES]|NO) ==> Specifies wether or not the LU expects ACF/VTAM 
to maintain the SSCP-PU session. 
The default value is yes. 


° Application program requested session termination, 
where an application program Ce.g. CICS/VS) requests session termi- 
nation with a secondary logical unit. 


In case of CICS/VS this kind of request can also be initiated by the 
connected terminal or the master terminal operator as shown belon. 
For example, the terminal operator enters the CICS/V5 command CSS5F 
LOGOFF at a terminal in session with CICS/VS; or, the master terminal 
operator enters one of the following commands: 


CSMT GLOSE,VTAM Cfor all connected terminals) 
CSMT SHUT,NO Cfor all connected terminals) 
CSMT TER,SIN,>... (for a specific terminal). 
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After these commands the terminal(s) are again in the SSCP-LU session 
and VTAM LOGON commands can be entered at the terminal. 
® Cperatcr requested session ternination, 
where the VTAM operator can cause a specified logical unit to be 
logged off from a specified application program. 
This is done by entering V WNET,TERM,ID=lLu-name from the system 
console. 
Also V NET,INACT,ID=lu-name has the same effect, as it will terminate 
the SSCP--LU session and therefore also the hierarchically lower LU-LU 
session. 
Recommendations for Session Termination 
Usually the application program requested session termination is used. 
This is where applications like CICS/VS, NCCF, etc. allow the terminal 
user or master terminal operator to request session termination via opera- 
tor commands. 


In special situations the other types of session terminations may be usad. 


CICS/VS will honor any of these methods of logging off. 


5.2 IPL DEFINITIONS 


To identify the attached devices to DOS/VSE "ADD commands’ must be speci- 
fied in the IPL procedure. Take your Configuration Documentation Sheet and 
update your IPL procedure as follows: 


5.2.1 Local Devices 


e non-SNaA 
—-  DISPLAY/PRINTER ADAPTER 
Each terminal must be added with devicatone 3277. 
e.g. ADD 009,3277 


Each terminal printer must be added with device type 3277 and mode 
01. . 


e.g. ADD 012,3277,01 


= IBM 3272-1,2 IBM 3274-1B,1D,21B,31D 
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Each terminal attached to one of these controllers must be added 
with device type 3277. 
e.g. ADD 080,3277 


Each terminal printer attached to one of these controllers must be 
added with device type and mode 01. 


e.g. ADD 087,3277,01 
e SNA 

- LOOP ADAPTERCLA) 
All IBM 3641/742/43/46/47's Clocal or remote) on the IBM 4331 LA 
must be added with address X'040' Ccommon PU) and device type 
3791L. 
ADD 040,3791L 
Each IBM 327473276, IBM 3287, IBM 3644, IBM 3645, IBM 8775 Clocal 
or remote) on the IBM 4331 LA must be added with device type 
3791L. 
e.g. ADD 041,3791L 

= IBM 3274-1A/-21A/-31A, IBM 3791 


Each control unit must be added with device type 3791L. 


e.g. ADD 080,3791L 


5.2.c Remote Devices 


A set of eight addresses, from X'030' to X'037', is reserved in channel 0 
of the IBM 4331 for the use of the CA. These addresses must be used to spe- 
cify to DOS/VSE the lines attached to the CA. 


For each line attached to the CA, an ADD statement must be included in the 
IPL procedure. 


ACF/VTAM supports only the BSC and SDLC line control disciplines of the 
CA. There is no support for start/stop lines. 

BSC lines under control of ACF/VTAM can only work with IBM 3270 BSC con- 
trol units. | 


e Each SDLC line must be added with device type 3705 and mode 10. 


e.g. ADD 030,3705,10 
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© Each BSC line must be added with device type 2703. 
e.g. ADD 031,2703 
Note: 


All these ADD commands should be created via the IPF - ASI Tailoring Dia- 
log. 


5.3 STARTUP DEFINITIONS 


The partition containing ACF/VTAM should have higher priority than parti-~ 
tions containing ACF/VTAM application programs; otherwise, the applica- 
tion programs may be unable to communicate with ACF/VTAM. 


¢ If cCICS/VS CF2 partition) is the only ACF/VTAM application program 
create a following PRTY statement: 


PRTY BG,FB,FA,F9,F8,F7,F6,F5,F4,F2,F3,F1 _ CF3 VTAM partition) 


® Tne size of the VTAM partition (CF3) in the ALLOC and ALLOCR commands 
can be defined as: 


184¢4K for the virtual storage CALLOC), and 
200K for the real storage CALLOCR). 


If you want to use a more exact storage allocation use the storage esti-~ 
mates in Appendix F of ACF/VTAM V2 Planning and Installation Reference. 


The ACF/VTAM partition can also run exclusive of VSE/POWER control and can 
start automatically during VSE system initialization. 
This is arranged in the following way: 


® Include the ACF/VTAM start job Cwithout POWER JECL statements) into 
procedure S3JCLxx 


® Add the "START F3' command in procedure SOJCLxx 


© Existing VSE/POWER start commands for F3 need to be removed from pro- 
cedure S1JCLxx. 


The ACF/VTAM start job considerations are discussed later in this chapter. 


Note: 
As far as possible use the IPF - ASI Tailoring Dialog. 


53 


Raleigh International Systems Center 


5.4 ACF/VTAM DEFINITIONS 


Now define the ACF/VTAM major and minor nodes. 
First Time Users may use the members created from the SIPO/E 3.1 SAMPLIB 
member 'VTAMBOOK’® and modify them according to the following rules. 


5.4.1 ocal Devices 


Non-SNA Devices 
Define your local non-SNA devices in one or several major nodes. 


The LBUILD definition statement for a non-SNA major node is the header, 
followed by the appropriate LOCAL statements for the minor nodes. 


e DISPLAY/PRINTER ADAPTER 


The Display/Printer Adapter appears to ACF/VTAM as an IBM 3272, so its 
definition to ACF/VTAM is similar to an IBM 3272 definition. 

The following job stream catalogs the definition book for a local 
non-SNA major node: 


// JOB LOCICT CATAL DPA Major node 
// LIBDEF SL,TO=USRSL1 
7/7 EXEC MAINT 
CATALS B.LOCI 
BKEND B.LOCI 


LOC LBUILD 

DS2L009 LOCAL CUADDR=009, % 
TERM=3277, 3278 DISPLAY 
FEATUR2=MODEL2, % 
LOGAPPL=DBDCCICS 

D92ZL010 LOCAL CUADDR=010, 3279 DISPLAY % 
TERM=3277, | % 
FEATUR2=MODEL2, % 
LOGAPPL=DBDCCICS 

D&§2Ll011 LOCAL CUADDR=011, % 
TERM=3277, 3278 DISPLAY % 
FEATUR2=MODEL2, x 
LOGAPPL=DBDCCICS 

P72L012 LOCAL CUADDR=012, * 
TERM=3286, 3287 PRINTER is 
FEATUR2=MODEL2, * 
LOGAPPL=DBDCCICS 

BKEND 
/* 
7& 
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° IBM 3272-1,2 and IBM 3274-1B8,1D,21B,21D,31D (channel attached) | 


The terminals/terminal printers on these non-SNA control units are 
defined as in the example above. 


Note: 
The IBM 3278/3279 display has to be specified as a 3277 and the IBM 3287 
printer as a 3286. 


By specifying LOGAPPL=DBDCCICS the device is automatically connected to 
DBDCCICS. 


If you are using a USS table (see the section ‘Recommendations for LU-LU 
Session Initialization’ in this chapter) replace this parameter with 
USSTAB=phasename. | 

In this case the LU-LU session has to be established from the terminal. 


SNA Devices 
Define your SNA devices in one or more major nodes. 


The VBUILD TYPE=LOCAL definition statement for an SNA major node is the 
header, followed by the appropriate PU and LU statements for the minor 
nodes. | 


° IBM 3274-1A,21A,314 


These SNA control units with their attached devices have only one phy~ 
sical address which must be specified in the PU statement. The fol- 
lowing job stream illustrates an IBM 3274-1A definition book for a 
control unit with 2 attached terminals: 


// JOB LOC2CT CATAL LOCAL SNA Major Node 
// LIBDEF SL,TO=USRSL1 
7/7 EXEC MAINT 
CATALS B.LOC2 
BKEND B.LOC2 


Loce VBUILD TYPE=LOCAL 

PUI1SF PU CUADDR=13F, % 
PUTYPE=2,; * 
MAXBFRU=5, x 
SSCPFM=USSSCS 

D82L1i3F1l LU LOCADDR=2, % 
LOGAPPL=DBDCCICS 

D82L13F2 LU LOCADDR=3, | x 
LOGAPPL=DBDCCICS 

BKEND 
7% 
/ & 
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° The LOOP ADAPTER 


At first, define the devices IBM 3641,3642,3643,3646,3647 locally or 
remotely attached, in the 'common PU! at address X'40". 


All other LOOP-attachable devices are represented by a separate PU macro 
definition, or you build several major nodes. 


The following job stream illustrates a LOCAL SNA major node with 
several IBM 364X devices: 


47 JOB LOCSCT CATAL LOOP SNA Major Node 
//7 LIBDEF SL,TO=USRSL1 
77 EXEC MAINT 
CATALS B.LOC3 
BKEND B.LOC3 


LOC3 VBUILD TYPE=LOCAL 

PU040 PU CUADDR=040, x 
PUTYPE=2, ¥ 
MAXBFRU=5, x 
SSCPFM=FSS, 4 
LOGAPPL=DBDCCICS 

TiL0401 LU LOCADDR=2 IBM 3641 

I2L0402 LU LOCADDR=3 IBM 3642 

I3L0403 LU LOCADDR=4 IBM 3643 

16L0404 LU LOCADDR=5 IBM 3646 Scanner one 

I6L0405 LU LOCADDR=6 IBM 3646 Scanner two 

I7L0408 LU LOCADDR=8 IBM 3647 

PU041 PU CUADDR=041, * 
PUTYPE=2, * 
MAXBFRU=5, * 
SSCPFM=FSS, % 
LOGAPPL=DBDCCICS 

I4L0411 LU LOCADDR=1 IBM 3644 

PU042 PU CUADDR=042, % 
PUTYPE=2, ¥ 
MAXBFRU=5, * 
SSCPFM=FSS, % 


LOGAPPL=DBDCCICS 


I5L0421 LU LOCADDR=1 IBM 3645 
BKEND 

7 

1% 


The following job stream illustrates a LOCAL SNA major node with an 
IBM 8775-1: : 


// JOB LOC4CT CATAL LOOP SNA Major Node 


7/7 LIBDEF SL,TO=USRSLI 
7/7 EXEC MAINT 
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CATALS B.LOC4 
BKEND B.LOC4 


PU043 PU CUADDR=043, % 
PUTYPE=2, % 
MAXBFRU=5, x 
SSCPFM=USSCS, x 
LOGAPPL=DBDCCICS 

D62L0431 LU LOCADDR=2 

BKEND 
/* 
4% 
Note: 


MAXBFRU specifies the number of buffers that will be allocated for READ 
operations from the PU. If the specified number of buffers is not avail- 
able, then the READ is postponed until the buffers are available. 


Specify a value large enough to hold the maximum RU size. That means: 
MAXBFRU x LFBUF-size >= maximum RU size. 


By specifying LOGAPPL=DBDCCICS the device is automatically connected to 
DBDCCICS. 


If a second CICS/VS is running at the same time and the devices should be 
able to access also the second CICS/VS, replace this parameter with 
USSTAB=tabname. In this case the LU-LU session has to be established from 
the terminal. This is not possible with IBM 3641742743/44/46/47 devices. 
On these device definitions delete LOGAPPL=DBDCCICS. Establish the LU-LU 
session via operator command at the system console: 


V NET,ACT,ID=lu-name, LOGON=DBDCCICS or TESTCICS 


5.4.2 Remote Devices 


Communications adapter major node(s) consist of one or more lines attached 
to the CA and the physical configuration defined for those lines. This 
configuration can include SDLC links (switched or non-switched), BSC 
lines (non-switched only), and the terminals attached to them. The minor 
nodes of the CA major node are lines, SNA physical units with their asso- 
ciated logical units, and the IBM 53270 BSC cluster control units with 
their associated terminals. 


The VBUILD TYPE=CA definition statement for a major node is the header, 


followed by the appropriate GROUP, LINE, PU, LU, CLUSTER, and TERMINAL 
statements for the minor nodes. 7 
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GROUP definition statement is required to indicate the beginning of a 


sequence of: 


LINE, PU, and LU statements for SDLC non-switched lines 
LINE, CLUSTER, and TERMINAL statements for BSC non-switched lines 


LINE, PU statements for switched lines (as described in Chapter 7). 


Point-to-Point Definitions 


The 


following JCL stream and ACF/VTAM definition statements are used to 


catalog a CA major node with a non-~switched IBM 3276 SDLC. 


// 3 
f/ 1 


OB REMICT CATAL CA Major Node SDLC 
IBDEF SL,TO=USRSL1 


// EXEC MAINT 
CATALS B.REML 


BKEND B.REM1 


REM1 VBUILD TYPE=CA 

GROUP1 GROUP LNCTL=SDLC, ss 
DIAL=NO 

LINEOQ31 LINE ADDRESS=031,? x 
MAXBFRU=(1,2), x 


PU031 PU ADDR=C1,?3 


RETRIES=7 2° 


PUTYPE=2, 
MAXDATA=262, ?2 
SSCPFM=USSSCS, 
LOGAPPL=DBDCCICS 


K K K K 


D62R0311 LU LOCADDR=2,?% x 


ISTATUS=ACTIVE 


D62R0312 LU LOCADDR=3,?°% % 


1% 
1% 


The 


ISTATUS=ACTIVE 
BKEND 


following sample shows definition statements and JCL stream for the 


IBM 3276 Cnon-switched) attached to the BSC link. 


11 


12 


13 


The channel unit address for the line. 

Number of PIU transmission retries; decrease this number with bad line 
quality. 

The SDLC station address assigned to this physical unit that will be 
used for polling and addressing. 

This address is defined during the control unit set up. 

An IBM 3276 or IBM 3274 attached to the Communications Adapter 
requires MAXDATA=262 or less. 

The local address of the logical unit starting with 2 Cport 0 = 
2,etc.). Each logical unit associated must be described by separate 
LU macro. 
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“7 JOB REM2CT CATAL CA Major Node BSC 
// LIBDEF SL,TO=USRSL1 
7/7 EXEC MAINT 

CATALS B.REM2 

BKEND B.REM2 

REM2 VBUILD TYPE=CA 

GROUP1I GROUP LNCTL=BSC 

LINEQ30 LINE ADDRESS=030!4 


CLO30 CLUSTER GPOLL=40,15 | * 
CUTYPE=3271, x 
ISTATUS=INACTIVE, * 
LOGAPPL=DBDCCICS 

D62R0301 TERMINAL ADDR=40,?° x 
TERM=3277; x 
FEATUR2=MODEL2, % 
ISTATUS=ACTIVE 

D62R0302 TERMINAL ADDR=C1,?° x 
TERM=3277, x 
FEATUR2=MODEL2, % 
ISTATUS=ACTIVE 

BKEND 

7% 

7& 


Refer to Figure 19 on page 38 where certain options in the network have to 
match. 


Multipoint Definitions 


To define a multipoint line, that is, a line with more than one PU, simply 
add your subsequent PU and LU statements after the first set of PU and LU 
statements. Make sure that the ADDR parameters for the PUs on the same 
line are all different, and that they are consistant with the addresses 
defined in the PUs themselves. The physical arrangement of the multipoint 
line Ca.g. analog, digital splitting) does not affect the ACF/VTAM defi- 
nitions of the line. 


14 The channel unit address for the line 
15 The general polling character assigned to the station during set up 
process. 
X'40" for the first control unit 
X'C1" for the second control unit 
X*'C2" for the third control unit ..... ete. 
One CLUSTER definition statement must be coded for each IBM 3270 BSC 
cluster control unit on the line. 
16 Device address by which ACF/VTAM will select the terminal. 
X°S6O" for port 0 
X' Ci for port. f 24486 etc. 


64 


Raleigh International Systems Center 


5.4.3 ACF/VTAM Application Programs 


All application programs in an ACF/VTAM domain must be defined to 
ACF/VTAM. A single application or a logical group of applications defined 
to ACF/VTAM is called an application major node. 


To identify an application major node, a VBUILD TYPE=APPL statement has 
to ba filed. For each single application a following APPL statement must 
be coded. 


The following job stream catalogs CICS/VS in an application major node: 


// JOB APPLICT CATAL APPLICATION Major Node 
// LIBDEF SL,TO=USRSL1 
7/7 EXEC MAINT 
CATALS B.APPLI 
BKEND B.APPL1I 
APPL1 VBUILD TYPE=APPL 
KH KKKKKX 
DBDCCICS APPL AUTH=ACQ, EAS=20 
HR KKXKHKN 
BKEND 
/¥ 
7% 


Note: 

DBDCCICS is the ACB-name of CICS/VS. This name must agree with the 
APPLID=name defined in the DFHTCT macr o TYPE=ENTRY or in the DFHSITxx. 
DBDCCICS is the default APPLID-name in a CICS/VS TCT generation and is 
also used in the SIPO/E 3.1 supplied DFHTCTSO. 


EAS=20 specifies the maximum number of concurrent sessions this program 
Will have with logical units. The recommendation is to specify 10 to 20 
percent more than the planned number of sessions. 


5.4.4 Selecting ACF/VTAM Start Options 


The Start List 


ACF/VTAM needs a set of start options to provide information about the 
conditions under which it is to run. 

In the absence of user-supplied values, ACF/VTAM will assume start option 
values. These values are described as the dafault start option formats in 
Chapter 17 and 12 of ACE/VTAM V2 Planning and Installation Reference. 
However, no default value for the required SSCPID parameter is provided. 
Therefore, the user has to code a book ATCSTROO, which is required and 
which must contain at least the option SSCPID=n. For a single system 
environment 'n’ should be set to 01. 
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During SIPO/VE 3.1 System Initialization, an ATCSTROO is cataloged by the 
job 'nSETUP'. However, the supplied start options are designed for 
ACF/VTAME and not for ACF/VTAM. . | 


Therefore catalog ATCSTROO as follows: 


//7 JOB STROOCAT CATAL ATCSTROO 
// LIBDEF SL,TO=USRSLI1 
/¢ EXEC MAINT | 
CATALS B.ATCSTROO 
BKEND B.ATCSTROO 
SSCPID=01 
BKEND 
“xX 
1% 


This start option is merged with the ACF/VTAM supplied default values. 


To modify or extend the IBM-supplied values one or more of the following 
techniques can be used: 


e Options can be modified by defining them in the B.ATCSTROO List. 


° The operator can enter options at the console during ACF/VTAM start 
procedure when he is prompted. | 


e The operator may enter a LIST=xx command during the ACF/VTAM start 
which will read an alternative cataloged start list B.ATCSTRxx. 


It is recommended that the additional start options be coded in the book 
B.ATCSTRO1I. | | 


The following example shows these start options designed for ACF/VTAM: 


// JOB STROICAT CATAL ATCSTROL 
// LIBDEF SL,TO=USRSL1 
¢¢ EXEC MAINT 
CATALS B.ATCSTROJ 
BKEND B.ATCSTRO1L 
CONFIG=01,!? 
MAXSUBA=15, 
HOSTSA=01, 
VFBUF=20480, 
NOTRACE, TYPE=VTAM?® 
BKEND 
7 
7% 


MK KK 


In this case the operator has to type in LIST=01 during the ACF/VTAM 
start. 
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The Configuration List 


The configuration list defines the major nodes to be activated when 
ACF/VTAM is started. ACF/VTAM will search the Source Statement Library 
for a configuration list filed under the name B.ATCCONO0 or B.ATCCONxx 
depending on the CONFIG=xx parameter coded in the used ATCSTRxx. ACF/VTAM 
will use this list, and will activate the major nodes in the sequence the 
nodes are coded and cataloged. 


Note thea following rules: 


If you use LOGAPPL=DBDCCICS in your terminal definitions to provide auto- 
matic logon to CICS, then you should put the application major node before 
the local and CA major nodes in the configuration list. This will activate 
the application prior to the terminals. 


The following job stream is an example of how to coda and catalog a con- 
figuration list. 


4/7 SOB CONOICAT CATAL ATCCONOL 
// LIBDEF SL,TO=USRSL1 
47 EXEC MAINT 
CATALS B.ATCCONO1 
BKEND B.ATCCONOL 
APPL1,LO0C1,REM1 
BKEND 
7% 
1% 


e APPL1 is the name of an application program major node 
e LOCc1 is the name of a local non-SNA major node 
e REM1 is the name of a CA major node 


The book name B.ATCCONO1 was selected because the CONFIG option in the 
B.ATCSTRO1 start list is 01. 


If the operator wants to override the usual configuration list, he can do 
this by entering LIST=01,CONFIG=xx at the system console, where xx points 
to a list ATCCONxx, which contains different major node names. 


Reasons for this change could be: 
e specific applications are started only on specific days 


® a specific network definition is used for a specific situation 
(backup) 


17 This parameter indicates that ACF/VTAM will use the configuration 
list ATCCONO1 to activate the defined major nodes at ACF/VTAM start 

| time (see next paragraph). 

18 No ACF/VTAM traces are started. In case of problems activate the trac- 
es as described in Chapter 9: Problem Determination. 
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(5.4.5 The ACF/VTAM Start Job 


Take the SIPO/E 3.1 supplied VTAM start job (member VIMSTRT) and modify it 
as follows: | 


* $$ JOB VT2STRT,DISP=H,CLASS=3 

// JOB VT2STRT 

// LIBDEF CL,SEARCH=C(PRDCLG,USRCL1) 

7/7 LIBDEF SL,SEARCH=CUSRSL1) 

// DLBL TRFILE,'*VSEIPOE.SNA.VTAM. TRACE. FILE' TRACE FILE 
// EXTENT SYS001,SYSWK1,1,0,111770,500 3310 DASD 
// ASSGN SYS001,240 

HE HEE DEE 3 EE HEHEHE EI I DE HE DEE DEDEDE DE DE EE DEE DE DE DEK DEE EK DK HEE DE IEEE HEH DEDEDE HE HE DE DE HC HEE EEE EE KE 
x ACF/VTAM START UP SINGLE DOMAIN 

% ENTER: xx LIST=33 SIPO/“E START LIST or xx LIST=xx YOUR START LIST 
HE HEN DEDE DE DE NE BE DEE DE EE EE IE DE HE DE IE DE EE DE DE DE DE EE HEHEHE HE I IE EE ENE DEDEDE CDE DE DE DE DE EC DE DE DE DE DE DE CE EK HC EEE 
// EXEC ISTINCVT,SIZE=1130K 

7& 

* $$ EOJ 


Note: 


@ The partition running ACF/VTAM should have higher priority than par- 
titions containing ACF/VTAM application programs. 


@ Check the size of the ACF/VTAM partition defined during ASI Tailoring. 


e The ACF/VTAM partition can run exclusive of VSE/POWER control and 
start automatically during VSE system initialization. 


e Do not use SIZE=AUTO on the EXEC statement. See Chapter 8: Perform- 
ance and Storage, for details. 


Refer to section: ‘Startup Definitions’ discussed earlier in this 
chapter. 


If ACF/VTAM runs exclusive of VSE/POWER control and is invoked by a proce- 
dure, you have to reinitiate ACF/VTAM after a Z NET,QUICK by entering : 


3 7% CEOJ) 
3 7/7 EXEC $3JCLxx 


at the system console. 
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5.5 TEST OF YOUR CUSTOMIZED ACF/VTAM DEFINITIONS 


Now you are ready to test your network definitions. 


Make sure that: 


the ASI procedure reflects your network, 
the ACF/VTAM B.books are cataloged defining your environment, 


the USSTAB is assembled and cataloged Cif necessary in your environ- 
meant) > 


the ACF/VTAM start job is submitted, 


the devices and lines that you want to test are not assigned to other 
partitions. 


Users with IBM 3644 and IBM 8775 Cenhanced/extended features) must consid- 
er additional prerequisites: 


The ACF/VTAM CNM routing table CISTMGC00) must have entries for the 
NSRU Cnon sequenced RU) of these devices and the DLUPULP CDSLU phys- 
ical unit load program). 


See DSLU Installation and Referance Guide. 


The micro code of these devices must be loaded via the DLULDPP CDSLU 
load data preparation program) into a VSE Core Image Library. 


IBM 3644 users must have generated user PTLs via the GEN3644 program 
product and must have loaded these user PTLs via the DLULDPP CDSLU 
load data preparation program) into a VSE Core Image Library. 


DLUPULP is started in a separate partition or is be activated after 
the ACF/VTAM start via F NET,ATTACH, ID=DLUPULP. 


If your CICS/VS is stopped, continue with step 2, otherwise: 


Ls 


Stop CICS/V5S 


If you have ACF/VTAM running, close the CICS-ACB by entering at thea 
system console: 


/TC 
xx CSMT CLOSE,VTAM 


and then stop ACF/VTAM by 
Z NET,» QUICK 


If you have ACF/VTAME running, shutdown CICS/VS by entering at the 
system console: 
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/TC 
xx CSMT SHUT,NO 
and then stop ACF/VTAME by 


Z NET,QUICK 


If you are running with BTAM-ES, shutdown CICS/VS by entering at the 
system console: | 


“TC 
xx CSMT SHUT,NO 


Release VT2STRT from the reader queue; 
the following F3 message will appear: 


xx 5A51A ENTER VTAM START PARAMETERS 
ENTER: xx LIST=01 


to start with the values in the appropriate start option list 
ATCSTROI. | 
Following F3 messages will appear, which you can ignore: 


xx 5A17I UNABLE TO LOAD PHASE ISTEXCVR 
xx 5A171I: UNABLE TO LOAD PHASE ISTSDCOS 


ACF/VTAM is now activating the major nodes you have defined in 
ATCCONO]. 

This is the first time syntax checking of your definitions is per- 
formed by ACF/VTAM. 


If there are no error messages, go to step 3, 
otherwise: 

e Make a hardcopy of the screens or print the VSE hardcopy file by: 
R RDR,PAUSEBG 


0 “7 EXEC PRINTLOG 
0 F3 


° Have ACF/VTAM V2 Messages and Codes and ACF/VTAM V2 Planning. and 


wWnstallation Reference available, 


Wh 


° Stop ACF/VTAM by 
2 NET,QUICK 


e Start your CICS/VS environment as usual. 
First time users (with ACF/VTAM) do this by: 


R RDR,VTAMSTRT and 
xx CSMT OPEN, ACB 
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e correct the errors via ICCF, and submit the updated jobs. 
e go tol. 


3. DISPLAY the status of your network by entering following ACF/VTAM com- 
mands: 


e D NET,TERMS or 
° D NET,ID=LOC1,E 


If all LUs are ACTIVE, check the SSCP-LU session at each keyboard terminal 
with the IBMTEST command (see next section). 
Otherwise proceed to Chapter 9: Problem Determination. 


On an IBM 3641742/446/45/46/47 you can not use the IBMTEST command. 


5.5.1 Initial Test with the IBNTEST Command 


Once the network has been activated by ACF/VTAM (see above), the keyboard 
terminal ‘user can test the physical path between ACF/VTAM and his 
terminal. Using the IBMTEST command enables the user to find out if all 
his initial definitions are working correctly or not, independent of his 
application program. 


The command IBMTEST causes test data to be returned a specified number of 
times to the terminal. The terminal user may specify the test data charac- 
ters, or if no data is given, a predefined sequence will be supplied by 
ACF/VTAM. After the logical unit has been activated (USS-message 10 
received) the terminal operator may enter: 


IBMTEST <n]10><,userdata> 


nj{10 ==> Number of times the test data should be returned. The maximum 
value of nis 255. The dafault value is 10. 


userdata ==> Test data to be sent back to the terminal. The default data 
are tha characters A-Z and 07-9. 


Note: 

During the execution of the IBMTEST, e.g. until the requested test message 
has been sent n times, no data entry is possible from the terminal 
tested. 


if an error occurs during IBMTEST ACF/VTAM will issue an error message on 
the operator console. The following error message is an example of an I70 
error during the test phase: 


5E73I CONNECTIVITY TEST TO NNNNNNNN TERMINATED AFTER X ECHOES DUE TO I/0 
ERROR, SENSE: 08060000 | 
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If the IBMTEST command is working correctly, the user can start with the 
implementation of his application programs Cin this case CICS/VS). 


Otherwise proceed to Chapter 9: Problem Determination. 


5.6 CICS/V3 DEFINITIONS 


CICS/VS is installed during SIPO/E 3.1 Base Install. The SIPO/E 3.1 Sys- 
tem provides at least one version of all CICS/VS system programs. Some of 
them are provided in three or four different versions to cover a wide 
variety of configurations and options. The program versions provided have 
been chosen to meet the needs of the majority of installations; they 
include the most frequently used options. 

The required version of each system control program can be selected. To 
Indicate to CICS/VS which versions, if any, of the different system pro~ 
grams are needed, a System Initialization Table (SIT) must be specified to 
CICS/VS. How this is done is described later in this chapter. 

Dafine CICS/VS tables 

Only tables that are related to specific installation or application 
requiraments (Cfor example network configuration, transactions, etc.) 
need to be generated, such as: 

® PPT - Application programs 

e PCT - Transactions 

* TCT - Tarminals 

° FCT - Files 

e DCT - Queued data 

e TST - Recoverable temporary storage 

° JCT - System and user journals 

e SIT - Execution and startup options 


° SNT ~ Sign-on password security 


At least the following CICS/VS tables will need customization because of 
ACE/VTAM: 


© DFHSIT System initialization table. 


e DFHTCT Terminal control table. 
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e DFHPCT Program control table. 
° DFHPPT Program processing table. 


Depending on the applications to be run under CICS/VS, other tables and 
programs may be needed. For example, if journaling is required a DFHJCT 
will be needed to describe the journal data sets and their characteristics 
for journal management. 


You have also to create the CICS/VS initialization JCL. 


5.6.1 Terminal Control Table Generation 


The Terminal Control Table macro instructions (DFHTCT) are used to speci fy 
the terminal environment to CICS/VS. In an SNA communications system, 
CICS/VS does not control the network. Instead a description of the 
ACF/VTAM controlled terminals associated with logical units that are 
going to communicate with CICS/VS is required. 


There are several types of DFHTCT macro instructions, which are used to 
specify terminals and communications lines to CICS/VS, which are con- 
trolled by ACF/VTAM or another access method such as BTAM/ES. 


If you have asynchronous or BSC devices (other than BSC 3270) which are to 
communicate with CICS/VS, you will need to have BITAM/ES to control them, 
as ACF/VTAM does not support these terminals. Define these devices and 
their lines in front of all ACF/VTAM controlled devices. CICS/VS then runs 
with different TELEPROCESSING ACCESS METHODS. 

Here only the ACF/VTAM controlled devices are discussed. 


The following DFHTCT macro instructions are needed to describe to CICS/VS 
the ACF/VTAM terminals that will be allowed to establish sessions with 
CICS/VS: 


DFHTCT TYPE=INITIAL 

This macro instruction must precede all other DFHTCT macro instructions in 
a terminal control table assembly. This macro establishes the area of sto- 
rage into which CICS/VS will assemble the terminal control table. Keyword 
entries in this macro give to CICS/VS information that will be needed to 
interface with ACF/VTAM. 


DFHTCT TYPE=TERMINAL 

Each terminal that is to communicate with CICS/VS requires one macro of 
this type. Keyword entries in this macro provide to CICS/VS the character- 
istics specific to each type of terminal supported and the name that iden- 
tifies this terminal in the ACF/VTAM network. Also a name is defined by 
which the terminal will be known to CICS/VS. 
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CICS/VS allows only four characters for the name of the terminal. Use the 
recommended naming convention and a compromise will have to be devised. 
The last macro of this type must have the parameter 'LASTTRM=VTAM'. 


DFHTCT TYPE=FINAL 
This must be specified on the last control card for the terminal control 
table assembly before the assembler END statement. 


Edit the SIPO/E 3.1 supplied DFHTCT$0 as mentioned in Chapter 3 and define 
your terminals as shown below. 


* $$ JOB JNM=TCTSVCT,CLASS=0 

// JOB TCTSYCT 

* ASSEMBLE AND LINK-EDIT CICS/VS TCT | DFHTCTSV 
// LIBDEF CL,TO=USRCL1 

// LIBDEF SL,SEARCH=(PRDSLG,PRDSLB) 

// OPTION CATAL, NOXREF 

//7 EXEC ASSEMBLY, SIZE=128K 


TCTS | TITLE "DFHTCTSVY SING. DOMAIN’ | 
HE HICH HEHEHE HE HEHEHE IE HEHEHE KDE HEH NE HE DE IE HEHE IK HEHE HEE DE HE HEHEHE HK HEHE DEI HE EK HEE IE HE DE DE DK HED DE IE HEE HEHE EEE OK 
KEIHIN BASED ON DFHTCTS$O SIPO“E TCT KKH KK RH K KKM X 


HK RRA HK KKH HK HK HK HK KKH HHH HHH HHH HHH HHH HH HEH HHH HK KKK AK HK K KKK KKK KKK KR KKKKKAKRRK X 
PRINT NOGEN 


TCTSV - DFHTCT TYPESINITIAL, STARTER=YES , SUFFIX= SV, x 
ACCMETH=(NONVTAM, VTAM) , x 
APPLID=DBDCCICS, APPLICATION ID x 
GMTEXT="DBDCCICS', GOOD MORNING MESSAGE TEXT x 
RAMAX=4096,, RECV ANY I/O AREA, BYTES x 
RAMIN=80, | DATA LEN TO XFER TO NEW TIOA X 
RATIMES=4, MAX NO TIOAS PER MSG x 
RAPOOL=6, RECV ANY'S x 
RESP=FME _ RESPONSE REQUESTED BY CICS 

HE HEHE IE HE HK DEE IEE KE EK IE KDE DE DE DE EE EE HE DE EE DE DEE HEE HE EE EE EE EE EEK EK KKK EK KEK KM KKK KKKKK & 

CNSL DFHTCT TYPE=SDSCI, BSAM CPU CONSOLE x 

| DEVICE=CONSOLE, - x 
DEVADDR=SYSLOG, x 

BLKSIZE=80 
DFHTCT TYPE=LINE, x 
TRMTYPE=CONSOLE, x 
ACCMETH=SAM, x 

INAREAL=80 
DFHTCT TYPE=TERMINAL, X 
TRMIDNT=CNSL, ¥ 


TRMSTAT=RECEIVE 
% PPS ESPN Ps RR Oe Me Dao Ter ts em meta SERS Den TUT PRIne Pe Panton Pe Pome era Perens Te PN Te mee me tere pe cere tei ama x 
x IBM 3278 — IBM 4331 DPA ATTACHED 
% HEHEHE HEE HEHEHE HEHE HEH HEHEHE DE HE HE DE HED HEI HEHE IK HE HEH HEHE HEH DEH HEHEHE HEH IEE HE HK HEHEHE HH HEH HEN HEHEHE HE IK x 
Lito DFHTCT TYPE=TERMINAL, 

TCTUAL=255, 

TRMIDNT=L1TO, 

-NETNAME=D82L009, DESCRIBED IN VTAM B.BOOK 

ACCMETH=VTAM, | 

GMMSG=YES, 


xx «xx «KK 
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TRMTYPE=L3277, 

TRMMODL=2, 

TIOAL=160, 

TRMSTAT=TRANSCEIVE, 

RELREQ=(NO,YES), 

FEATURE=(COPY,DCKYBD,SELCTPEN, UCTRAN, AUDALARM), 

PGESIZE=(24,80), 

PGESTAT=PAGE, 

PRINTTO=(LIP1) 
He HEH IK EK EEK EK KK EK EE KE KK KK EE EE IEE EE EE EE EE EE EE EK EK EK EE EEK KKH MMMM 
x IBM 3286 IBM 4331 DPA ATTACHED 
HM HEI HH HK HEE KE HE EK KK EK EE EEK NE EE HE KE EEE DE EK DE IE HE EE IE EE EEE HE EE HE EE EE EE EEE EEK HEM 
LiPi DFHTCT TYPE=TERMINAL, 

TCTUAL=255, 

TRMIDNT=L1P1, 

NETNAME=P72L012, DESCRIBED IN VTAM B.BOOK 

ACCMETH=VTAM, 

GMMSG=YES, 

TRMTYPE=L3284, 

TRMMODL=2, 

TIOAL=2200, 

TRMSTAT=RECEIVE, 

RELREQ=(NO,YES), 

FEATURE=C(PRINT), 

PGESIZE=(24,80), 

PGESTAT=AUTOPAGE 
HK HK HHH HK HE HK HE IE EE SEH KE KK HK EE EE SE HE EE EE EE EE EE EK KE EEK HR KHER HK HRM 
x IBM 3278 IBM 4331 / IBM 3274-14 CHANNEL ATTACHED 
HEHE IE IE IE HE IEE IE IK HE IE EE IE HE DE HE IE HE DE HE DE IE EI KIEL IE HE HEHE DEE HEE IE HEE IE HK HE KE HEE HEH KH HK MK KK NRK KH 
L2T1 DFHTCT TYPE=TERMINAL, 

TCTUAL=255, 

TRMIDNT=L2T1, | 

NETNAME=D82L13F1, DESCRIBED IN VTAM B.BOOK 

ACCMETH=VTAM, 

GMMSG=YES, 

TRMTYPE=LUTYPE2, 

BRACKET=YES, 

CHNASSY=YES, 

RUSIZE=1024, 

BUFFER=1536, 

TRMMODL=2, 

TIOAL=(1024,4096), 

TRMSTAT=TRANSCEIVE, 

RELREQ=(NO,YES), 

FEATURE=C(DCKYBD, SELCTPEN, UCTRAN, AUDALARM) , 

PGESIZE=(24,80), 

PGESTAT=PAGE, 

PRINTTO=(L1P1) 
HE HEHE IEE HE DE DEKE HE DE HE EK KEE EEE 3K DE IE DE EE DE HE IE KK EE DE DE HE EE EE KE EK KE IE EE DE EE EE EE EEE KEK MM KM 
x IBM 3641 IBM 4331 LA ATTACHED 
HE HEI HE EK HK HEE KE HE EE EEE HEE EE EK HE HE DE HE SE IK DK HE KEE EK EE EE EK EE EK EE EE EEE EK 
L3TO DFHTCT TYPE=TERMINAL, x 

TRMIDNT=L3T0, x 

NETNAME=I1L04601, DESCRIBED IN VTAM B.BOOK x 


KM KK KK KK OK 


KM KK KM KK KK KK KK OK 


mM KK mM KK KK KKK MK KK OK OK OK OK 
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TCTUAL=32, 

ACCMETH=VTAM, 

GMMSG=YES, 

TRMTYPE=INTLU, 

BRACKET=YES, 

CHNASSY=YES, 

RUSIZE=256, 

BUFFER=256, 

TIOAL=(256,500), 

TRMSTAT=TRANSCEIVE, 

RELREQ=(NO, YES), 

BMSFEAT=NOROUTEALL 
HE 9E HE HE HEHE DE HEHE HEE DEE DE HK DEKH DEE DE HK DE DE IK HEE HK EH HK HEHE EEK HEHE HK HK HM HIK MK KK HK MKK KKH 
% IBM 3642 IBM 4331 LA ATTACHED 
PME Ee Sete Sees Les e Les E ss ESE SESS E SESE SSS ES SSE SPSS SSS S SS ESSE SSPE SES SSS SS ee 
L3T1 DFHTCT TYPE=TERMINAL, 

TRMIDNT=L3T1, 

NETNAME=I2L0402, DESCRIBED IN VTAM B.BOOK 

TCTUAL=32, | 

ACCMETH=VTAM, 

GMMSG=YES, 

TRMTYPE=SCSPRT, 

BRACKET=YES, 

CHNASSY=YES, 

RUSIZE=256, 

BUFFER=1024, 

TIOAL=1536, 

TRMSTAT=RECEIVE, 

RELREQ=C(NO, YES) 
HEHEHE HK HEHE HIE HEH HEH HEED HE DEDEDE DEE HE DK HEE DEH DE HE DE DE DE HE DE IE DE IK DE DK HC EDIE EH EHH HHH HRM HHH 


MM KK KK KK KK XK 


Km KKK KK KK KK KK XK 


x IBM 36453 IBM 4331 LA ATTACHED 
HEHEHE IEEE HEHEHE HE EYE DEE IK HE DE HE DEE IE EK EH HE DEK HE HEC IE IE DEDEDE HE HE HE CH HHI KK KKK 
L3T2 DFHTCT TYPE=TERMINAL, 
TRMIDNT=L3T2, 
NETNAME=I3L0403, DESCRIBED IN VTAM B.BOOK 
TCTUAL=32; 


ACCMETH=VTAM, 
GMMSG=YES, 
TRMTYPE=LUTYPE2, 
TRMMODL=1, 
BRACKET=YES, 
CHNASSY=YES, 
RUSIZE=256, 
BUFFER=600, 
TIOAL=(600,1500), 
TRMSTAT=TRANSCEIVE, 
RELREQ=(NO,YES), 
ALTSCRN=(12,40), 
ALTPGEN=(12,40), 
DEFSCRN=(12,40) 

HEE EEK EEE EEE EE EK EK EE KK EK DE EK DE EE EE DE EEE EE EK KE KE EK KE EEE EEE KKM K KH 


mM mK MK KK KK KK KK KOK OK OK OK OK 


x IBM 8775 IBM 4331 LA ATTACHED 
HH HK HHH HEE HE KH HEHE HK HE HED HE HE IK HE HK 3 HE HK IE HK DK HE DED HE DE DE DK DH HE DK DK EDK DE IK DK DE DK IEE EEE HHH X 
L4T0 DFHTCT TYPE=TERMINAL, | X 
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TCTUAL=255, 

TRMIDNT=L4T0O, 

NETNAME=D62L0431, DESCRIBED IN VTAM B.BOOK 

ACCMETH=VTAM, 

GMMSG=YES, 

TRMTYPE=LUTYPE2, 

BRACKET=YES, 

CHNASSY=YES, 

RUSIZE=1536, 

BUFFER=1536, 

TRMMODL=2, 

TIOAL=(256,4096), 

TRMSTAT=TRANSCEIVE, 

RELREQ=(NO,YES), 

FEATURE=CDCKYBD,SELCTPEN,UCTRAN, AUDALARM), 

ALTSCRN=(24,80), 

ALTPGEN=(24,80), 

DEFSCRN=(24,80), 

PGESIZE=(24,80), 

PGESTAT=PAGE, 

PRINTTO=CLIP1) © 
HEH HEHEHE HE HE HEE HE DE HE DK DEE DE DK HE ED DK DEE HK DK HE EK HE EE HE DE EK EH HE HEH KH MK HHH HK KH KKK KK KH X 
x IBM 3278 IBM 4331 CA 7 IBM 3276 SDLC ATTACHED 
HE HEE KICK HEHE HEHE DE HK HE DE DK DE DE DE DK DE DE DK DE HE DE DE EE OK EE HE HE HE DE HE DE EEK HE EDEN HEE HEH KKH KKK KK KKK 
R1TO DFHTCT TYPE=TERMINAL, 

| TCTUAL=255, 

TRMIDNT=R2T0, 

NETNAME=D62R0311, DESCRIBED IN VTAM B.BOOK 

ACCMETH=VTAM, 

GMMSG=YES, 

TRMTYPE=LUTYPE2, 

BRACKET=YES, 

CHNASSY=YES, 

RUSIZE=1024, 

BUFFER=1536, 

TRHMODL=2, 

TIGAL=(1024,4096), 

TRMSTAT=TRANSCEIVE, 

RELREQ=C(NO,YES), 

FEATURE=CDCKYBD, SELCTPEN, UCTRAN, AUDALARM), 

PGESIZE=(24,80), 

PGESTAT=PAGE, 

PRINTTO=CLIPI) 
HE HEHEHE DE HEE DEE DE DE DE DEE HEE HK HEHE HEIDE KE IE HEHE DE HEE HK HEHE HK HEH HEE HE HEH HEHEHE HHH HHH HH HHH MMH KKH 
x IBM 3278 IBM 4331 CA 7 IBM 3276 BSC ATTACHED 
HEH DE HEE HEH HEH DEN HE DE DE DK HK HE DEDEDE HK EE HEHE EH HEHE EK HEH HH HEH HK HH HH HK HH HK KKK HKKKK 
R2T0 DFHTCT TYPE=TERMINAL, 

TCTUAL=255, 

TRMIDNT=R2T0, 

NETNAME=D62R0301, DESCRIBED IN VTAM B.BOOK 

ACCMETH=VTAM, 

GMMSG=YES, 

TRMTYPE=L3277, 

TRMMODL=2, 


~ KKM KKK WK mR KK KK KKK OK OK OK OK XK 


«KK KK KK KKK OK OK OK OK OK OK OK OK OK 


mM KK KK KK MK 


Chapter 5: Single System Environment V7 


Raleigh International systems Center 


TIOAL=160, 
TRMSTAT=TRANSCEIVE, 
RELREQ=(NO,YES), . : . 
FEATURE=C(COPY,DCKYBD,SELCTPEN, UCTRAN, AUDALARM), 
PGESIZE=(24,80), 
PGESTAT=PAGE, 
PRINTTO=CLIP1), 
LASTTRM=VTAM : 
JE 9G DE HEE DE DE DE IE DE DK DE DEE DE DE DE HK HE EK HEE DE DE DE DK DE IE DE DE DE DE DE DE DE DE DE DE DE DE DE DE EK HK DE DE EE DE IE DE EEK KEK KKH 
DFHTCT TYPE=FINAL 


KM KK KM KM KK 


END 
/* | 
4¢7 EXEC LNKEDT 
7% 
* $$ EOJ 
Note: 


Match the NETNAME with your ACF/VTAM minor node name. 
All screens are defined with a screen size of 24 x 80. For details refer 


to CICS/VS System Programmer's Reference 
Users of IBM 3641/42/44/46/47s need to obtain the definitions for these 
davices by generating an 'AASTTT' (Terminal Transaction Table). Include 


these definitions with the ICCF Editor. For details see: Loop Adapter 
CICS/VS PRPQ Programmer's Guide. 


A PRP (5799-BEH) is prerequisite to work with these devices CINTLU). 
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5.6.2 Program Control Table Generation — 


Edit the SIPO/E 3.1 supplied DFHPCTAS as mentioned in Chapter 3 and add 
your entries. 


* $$ JOB JNM=PCTSVCAT,CLASS=0 


7/7 JOB PCTSVCAT 
* ASSEMBLE AND LINK-EDIT A CICS/VS PROGRAM CONTROL TABLE 
// LIBDEF CL,TO=USRCL1 
// OPTION CATAL, NOXREF 
// EXEC ASSEMBLY, SIZE=128K 
TITLE "DFHPCTSV SING. DOMAIN’ 


PCTS 


et £.0.3.2,.2.0,0,0,0,5,0,9.0. 0.0.0.0, 0,0,. 0,0. 0.0.5.0, 0.0, 0,0, 0.0.0. 0,0, 5,0, 0,0, 0.0.0.0. 0.0, 010. 0,0,0,0,.0, 0.0. 0.0.0, 0,.0, 0 2S t tt 


BASED ON DFHPCTAS SIPO/E PCT KKK HK KKK KKK 
He HEHEHE HK HEHEHE EK HEE HE YK HEE HE DE HE IE IE HE HEI IC IK HEE HE DEK HEE DE DE DE HE HED HK DE DE IE HK DE DEK HE DE HE EH HEHEHE KEE HK 


KH KKK HKMKKK KK KKH 


PCTSV 


ee @ @ 


HK HHH HK KKK KK HK HK HK HH NHK HEH KH HEH HK HHH HK EK HK HK HEHEHE KK KK HH HHH HHH HK HHH HK HK AK HK KKK KK 


PRINT NOGEN 


DFHPCT TYPE=INITIAL,SUFFIX=SV 


o#8e #86 @ @ ee @ @ 


* THE FOLLOWING ENTRIES ARE FOR USER TRANSACTIONS 


HE HEHEHE HEHE HIE HE HEHE HEH HEIDE HEH HIE HC HEHEHE HK EHH IEE HE HE HK HEHEHE HH HHH HH HEHEHE HHH HEHEHE IK HK HE 


oe 8 86 


HE HK HHH HEH HK HEE HK HK HEE HEE HK HK HE EK HEH HK EK HE HE HEE HEE EK KE DE KE DE DE EK HK HE EE EH EEE HK KE HK KKH 


oee8f 0 @ @ 


*% THE FOLLOWING ENTRIES ARE FOR CICS/VS 


YE HHH HHH HIE HK HEHEHE HE HICH HEHEHE HEHEHE HE HEH HEHE HE HEI HC HE IH HEHE IK HH IE HH HEE HCH HHI HK HK KK 


HE HH HEHEHE HEH HH HEHEHE HEHEHE HHH HEHEHE IE HEH HEE EI HEE HEHEHE HEHEHE HIE HHH HIE HHH HEH HK KH KICKIN 


* THE FOLLOWING ENTRIES ARE CICS/VS SYSTEM ENTRIES FOR VTAM 


HE HEHE DEH EK EH HE EH IK HE HK EE EK DE HE EE EEK HK HEH HE KH HEE HK E KKH HHH HHH HH KH HK KH HK HK KK 


RESEND 
RESPLOG 
VTAM 


VTAMPRT 


eoeeeee 


oo @¢ 2 8 @ 


DFHPCT TYPE=GROUP, 
FR=RESEND 
DFHPCT TYPE=GROUP, 
FN=RESPLOG 
DFHPCT TYPE=GROUP, 
FN=VTAM 
DFHPCT TYPE=GROUP, 
FN=VTAMPRT 


oe e@ © © @ 


VTAM RESEND PROGRAM 


VTAM RESPONSE LOGGING 


VTAM ABNORMAL & SIGN-ON PROG 


VTAM 3270 PRINT FUNCTION 


* 


x 


* 


*K 


* 


* K 


HK KKH KKK HH KH KH HHH HK HK HK HK HEH HK HEH HEHEHE HH HK EH HK EH HEI HE HHH KKK KKH KK KKK KKKKKKKK X 


7% 


DFHPCT TYPE=FINAL 
END 


// EXEC LNKEDT,SIZE=64K 


1*% 
7% 
* $$ EQJ 


Notes: 


These four group entries are mandatory for ACF/VTAM. 


For details refer to: 


CICS/VS System Programmer's Reference Manual. 
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5.6.3 Program Processing Table Generation 


Pick up the SIPO/E 3.1 supplied DFHPPTAS as mentioned in Chapter 3 and add 
your entries. 


* $$ JOB JNM=PPTSVCAT 

7/ JOB PPTSVCAT 

* ASSEMBLE AND LINK-EDIT A CICS/VS PROCESSING PROGRAM TABLE 
// LIBDEF CL,TO=USRCL1 

// LIBDEF SL,SEARCH=(PRDSLG,PRDSLB) 

// OPTION CATAL,NOXREF 

// EXEC ASSEMBLY, SIZE=128K 


PPTS$ TITLE "DFHPPTSV SING. DOMAIN’ 
HE HEE HE DE HE DEE HE DE DE KDE HEE IK DE DE DE DE EDK DE DE HK DEE CDC DK DK KE DE DEK DEK IEDC DEE EEK KK MK KKK 
HK HMM KM KKK KN BASED ON DFHPPTAS SIPO/E PPT RXNRKRKKKKRRKK 


% HHH KKK KKK K KKK KKK HK HK KK HK HHH HK HHH KKK HK HK HK HK HK HH AK KKK HK KKK K RHA KKK HK KKK KKK KKH X 
PRINT NOGEN 
PPTSV DFHPPT TYPESINITIAL,SUFFIX=SV 


*K 


INSERT YOUR ENTRIES AT THE BEGINNING. 
ME HEE IE HE HEHE DE IEE NE DE IE HE DEE DE DK HEE DE DEK DK DE DE IE DE HK OE OE HK DE DE EK HK KE DEK DK EK EE EK KKK KKK X 


*K 


eo°@ = *¢ @ @ © @¢ @ @ @ @ @ 


He HK HK HK HE HE KE EE IE EK DE EE HK EK HE KE HE HK DE EEK DE EEK EK KE KK EK KH EEK MH KKH KKK KKK KKK KAKKK HK 


* THE FOLLOWING ENTRIES ARE FOR CICS/VS VTAM SYSTEMS % 

HE HEHE HEHEHE EE HIE DE IEE IE HEH HEHE HEH EK HEH HEHE HK HE HEHE EH EK KKK MK KKK KKK KK KKK 

RESEND DFHPPT TYPE=GROUP, | x 
FN=RESEND VTAM RESEND PGM 

RESPLOG DFHPPT TYPE=GROUP, | x 
FN=RESPLOG VTAM RESPONSE LOGGING PGM 

VTAM DFHPPT TYPE=GROUP, x 
FN=VTAM » ABNORMAL COND & SIGN-ON PGM 

VTAMPRT DFHPPT TYPE=GROUP, X 
FN=VTAMPRT VTAM TERM CONT PRINT KEY PGM 


HE HEHE HEHEHE IE DEE EE DE DE IE EEE IEE IEC DE DC DE DEE DE DE DE IE DE DE DE DEE IE EE I HE DE DE DC DE EE IEE DK DC EEK KKM 
DFHPPT TYPE=FINAL 
END 

/¥ 

//7 EXEC LNKEDT,SIZE=64K 

/¥ 

/& 

*¥ S$ EOJ 


Note: 
These four group entries are mandatory for VTAM. 
For details refer to: CICS/VS System Programmer's" Reference Manual. 


Users with IBM 3641/42/44/46/47s have to include also the CICS/VS PRP 
programs. 


For details refer to: Loop Adapter CICS/VS PRPQ Programmer's Guide 
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5.9.4 Program List Table Generation 


Users with IBM 3641742/44/466/47's have to create a DFHPLTxx. 
This is done in the following way: 


* $$ JOB JNM=PLTSVCAT 
// JOB PLTSVCAT 
* ASSEMBLE AND LINK-EDIT A CICS/VS PROCESSING PROGRAM TABLE 
// LIBDEF CL,TO=USRCLI1 
7/7 LIBDEF SL,SEARCH=C(PRDSLG,PRDSLB) 
// OPTION CATAL,NOXREF 
// EXEC ASSEMBLY,SIZE=128K 
PLTS$ TITLE "DFHPLTSV SING. DOMAIN’ 
PRINT NOGEN 
PLTSV DFHPLT TYPE=INITIAL,STARTER=YES,SUFFIX=SV 
AASMIPI DFHPLT TYPE=ENTRY,PROGRAM=AASMIPI 
DFHPLT TYPE=FINAL 
END 
7% 
// EXEC LNKEDT,SIZE=64K 
/¥® 
1% 
x $$ EOJ 


Note: 


For details refer to CICS/VS Svstem Programmer's Reference and to Loop 
Adapter CICS/VS PRPQ Programmer's Guide. 


5.6.5 System Initialization Table Generation 


The initialization of CICS/VS is both flexible and dynamic. The flexibili- 
ty is provided by the system initialization table (DFHSIT). The contents — 
of the DFHSIT macro instruction, which is assembled as a table, supplies 
the system initialization program with the information to initialize the 
system to suit the user's unique environment. During the initialization 
process the user is given the opportunity to change some of the parameters 
dynamically, if required. 


The information contained in DFHSIT may be grouped into the following 
three categories: 


° Information used to initialize and control system functions, for exam 
ple: storage cushion size, partition exit time interval, etc. 


° Module suffixes used to load the user-specified CICS/VS control mod- 
ules and tables, for example: DFHPCTxx, DFHTCTxx, etc. 


e Special information used to control the initialization process. 
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The user has also the flexibility of generating several system initializa- 
tion tables and selecting the appropriate one at the time of initializa- 
tion of CICS/VS. 


Edit the SIPO/E 3.1 supplied DFHSITSO as mentioned in Chapter 3 and 
modi fy: 


// JOB SITSVCT 

* ASSEMBLE AND LINK-EDIT A CICS/VS-SIT DFHSITSV 

// LIBDEF CL,TO=USRCLI 

//7 LIBDEF SL,SEARCH=C(PRDSLG,PRDSLB) 

// OPTION CATAL, NOXREF 

// EXEC ASSEMBLY, SIZE=128K 

SIT$ TITLE *DFHSITSV SING. DOMAIN’ 

ME HEHE DEE EK EEE HE DEE EEE IE EE DE EK IE DE DE DEE DE EEE HE EEE EEC EE KEK MH KKM KN 

% KKK KM KKK KH BASED ON DFHSITSO SIPO/E SIT MR RKRKKKKKRK % 

HHH HEHEHE IEEE HEH EE HEHEHE EDK HEHE HEE DIE HE HE IK DK HEHE IED HE IC DEED HE IE IDE HE HED IK DE HE HE HIE DEKE EK IE EIN 
PRINT NOGEN | 


SITSV DFHSIT TYPE=CSECT,STARTER=YES,SUFFIX=SV, X 
AMXT=..> MAX ACTIVE TASKS X 
CMXT=C. 22> MAX CLASS TASKS X 
Daravererare DOS/VS DL/I X 
DCT=(SV,COLD), VTAM EXTRA + INTRA X 
EXITS=YES, USER EXIT INTERFACE X 
FCT=.., FILE CONT+ TABLE x 
MXT=.. >» SPECIFY NO TERMNLS+1 x 
PCT=(SV,COLD), VTAM SINGLE DOMAIN PCT X 
PLTPI=SV, SYS INITIAL PLT x 
PPT=(SV,COLD), VTAM SINGLE DOMAIN PPT X 
SRP=1$, | SYSTEM RECOVERY PROGRAM X 
SRT=1$, SYSTEM RECOVERY TABLE x 
START=COLD, SYSTEM COLD START x 
TCP=ES, | CONS + VTAM 327073600/3790/PAl X 
TCT=C(SV,COLD), VTAM SINGLE DOMAIN TCT X 


END 
/¥ 
// EXEC LNKEDT 
/& | 
* $$ EOJ 


Note: 


oe © eo © &@ @ 


ZCP=ES, 
DUMMY = DUMMY 


CONS + VTAM 32707360073790/PA1 X 


TO END MACRO 


Only the mandatory entries for a CICS/VS running with ACF/VTAM are shown 


above. 


Insert your installation depended values where appropriated. 


For details refer to the CICS/VS Svstem Programmer's Reference Manual. 
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Users with IBM 3641/42/44/46/47 have to include following parameters: 
® EXITS=YES (that activates the User Exit Interface) 
e PLTPI=xx refers toa Program List Table as described earlier. 


® DCT =xx refers to a Destination Control Table in which the needs for 
a IBM 3642 transaction are covered. 


For details refer to the Lo dapter S$/VS PR Programmer's Gui 


5.6.6 CICS/VS Execution 


Take the SIPO/E 3.1 supplied job stream (xICFCVEM) and modify it as shown 
below. This start job is valid for an IBM 3310 DASD layout. 


x $$ JOB JNM=ICFCVSV,DISP=L,CLASS=2 
// JOB ICFCVSV VSE/ICCF STARTUP WITH CICS/VS 3310 AND VTAM. 
7/7 UPST 00011000 RECONFIG FROM SYSRDR. UPSI BITS D & E ARE ON. 
// LIBDEF CL,SEARCH=CUSRCL1,PRDCLB,PRDCLG,PRDCLC), FROM=IJSYSRS, TEMP 
// LIBDEF RL,FROM=PRDRLA, TEMP 
// LIBDEF SL,FROM=PRDSLA, TO=USRSL1, TEMP 
7/7 ASSGN SYS010,DISK,TEMP,VOL=DOSRES, SHR ASSGN FOR DTSFILE 
// ASSGN SYS041,DISK, TEMP, VOL=SYSWK4,SHR ASSGN FOR CICS/VS FILES 
7/7 ASSGN SYS009,SYSLOG 
// ASSGN SYSO031,SYSPCH 
4/7 EXEC IDCAMS,SIZE=AUTO 
VERIFY FILE (DFHTEMP) CIcS FILES 
VERIFY FILE (DFHNTRA) 


hwo Grdene USER FILES 
/% 
// EXEC DTSINIT,SIZE=3840K 
10000000 TERMINAL CONTROL UPSI SETTINGS 
768 NEW DEFAULT PARTITION SIZE 
YES CHANGE PARTITION SIZE AND CLASS 
00,1.5,0,T NEW DEFAULT PARTN SIZES AND CLASSES 
01,768,0,BCA NEW DEFAULT PARTN SIZES AND CLASSES 
END PARTITION SIZE DEFINITION 
YES PFIX I/70 AREA 
NO CHANGE CONFIGURATION 
SIT=SV, SYSTEM INITIALIZATION TABLE 
DCP=FS, DUMP CONTROL FOR 3310 
TRP=CFS,0N), TRACE CONTROL - MAIN STOR + AUX ON 3310 
DCT=AS, DESTINATION CONTROL FOR 3310 
SEND 
/% 
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7% 
x $$ EOJ 


Note: 

SIT=SV¥ specifies DFHSITSV as the system initialization table to be used 
for this execution of CICS/VS. 

Take care, that the CL-SEARCH sequence fits to your installation needs. 


Submit this job into the VSE/POWER queue and release it always after 
ACF/VTAM is started. 

During CICS/VS start, the user may get different messages from the ones 
shown here, depending on the options defined. 


weet ee wee TEN Cow tee Wher thee tie URS me te le See Gre temp Gee tame te Gee Qnae Wile See Gung Wee Wee Ges Gee Gee Gene Gane Gane Ue Gee Ce Ge Gem fone Gem hee tee ee Ge Ge Gee Ge Gee hh Ge ane tree GeeE Whee we ee tees fee Wee Cue cen ee Cn We ee slp BER Wo Oe ORD 


F2 00 DFHI500 - LOADING CICS NUCLEUS 

F2 00 DFH1596 - PL/I MODULE WILL BE INCLUDED 

F2 00 DFH1500 - TRANSIENT DATA SETS ARE BEING OPENED 
F2 00 DFHIi500 - TERMINAL DATA ARE BEING OPENED 

F2 00 DFHi500 - DUMP DATA SET IS BEING OPENED 

F2 00 DFH1500 - INITIALIZING TEMPORARY STORAGE 

F2 00 DFH1500 ~ LOADING RESIDENT APPLICATION MODULES 
F2 00 DFHi500 - SUBPOOL SIZE FOR THIS START-UP IS 724K 
F2 00 DFH1560 - CPU TERMINAL SUPPORT AVAILABLE 

F2 00 DFH1500 - STXIT PC MACRO IS BEING ISSUED 

F2 00 DFH1500 - STXIT AB MACRO IS BEING ISSUED 

F2 00 DFH1500 - CONTROL IS BEING GIVEN TO CICS 


At this point CICS/VS is ready to contact all terminals defined by 
LOGAPPL=DBDCCICS CLU-LU session establishment) or to accept logon mes~- 
sages from the defined terminals in the network. 


5.7 TEST OF YOUR CUSTOMIZED CICS/VS DEFINITIONS 
CICS/VS commands provided for management of the resources under control of 
CIcS/VS can be used te test your definitions. 


The CSMT and/or the CEMT commands can be used to display the status of 
your defined terminals. 


At first create an open reply to CICS/VS with 
“TC 


entered at the system console. 
After this, enter: 


CSMT TERMNL,SIN,INQ,TERMID=xxxx to display a single terminal or 
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CEMT INQ TER or 
CEMT INQ NETNAME to display all terminals. 


All powered-on devices, defined with LOGGAPPL=DBDCCICS and 
ISTATUS=ACTIVE, should be IN SERVICE CINS) and CONNECTED TO VTAM CACQ). 


The CICS/VS Good Morning Message appears on these devices. 


On IBM 3641744745746/47 devices you have a status, which is defined in 
your initialization program of the device. The initialization programs 
are activted by the CICS/VS PRP@ supplied Good Morning Message exit pro- 
gram. 


Check keyboard terminals with the command: 


CEMT INQ TAS or 
CSMT TAS 
using the TRMIDNT of the terminal. 


It is suggested that you attach a label containing the TRMIDNT at the ter- 
minal, so that the user is able to refer to it should problems occur. 


Now type ina valid transaction code to check the input/output function of 
these devices. 


Loaging of f from CICS/VS 


To logoff from CICS/VS the command 
CSSF LOGOFF 


can be used at the terminal. After the command 1s entered and accepted, a 
CICS/VS message is displayed indicating that the session is terminated; 
the terminal will again be in the SSCP-LU session. 


The LU-LU session is terminated and can be reinstated by hitting the SYS- 
REQ key Cif LOGAPPL=DBDCCICS is used), which will establish the LU-LU ses- 
sion (the CICS/VS Good Morning Message appears) again. 


After each defined terminal is running with CICS/VS, you should delete 
ACF/VTAME or ACF/VTAM R3 from USRxLi with the job DELVTAM from ICCF Lib 
59. 

Having done this the SIPO/E 3.1 supplied VTAM start job will not run any 
more. 
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6.0 MULTI SYSTEM ENVIRONMENT 


It is assumed that the user has an IBM 4331 with locally and remotely 
attached 3270's and 364x's in a multi system environment. Terminals and 
applications are able to have sessions with resources located in others 
domains. The IBM 4331 is connected to another IBM 4331 via the CA link or 
to another host via a link attached ACF/NCP. 

This chapter contains information about: 


e the definition of terminals/terminal printers 
in VSE, ACF/VTAM and CICS/VS, 


e the session establishment between ACF/VTAM and these terminals, 
° the ACF/VTAM Tables, 

e the definition of CICS/VS as an ACF/VTAM application, 

® the definition of a PEER to PEER link in ACF/VTAM, 

e the definition of a upstream link to a 3705 in ACF/VTAM, 

e the cross-domain definitions in ACF/VTAM, 

e the ACF/VTAM start options, 

e the session establishment in a cross-domain environment, 

® the CICS/VS tailoring, 


@ and the verification of the installation. 
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6.1 PREREQUISITES TO THIS CHAPTER 


6.1.1 Hardware 


It is recommended that set up of the CPU, the attached terminals, control 
units and modems is completed in each domain. The hardware tests should 
have been performed. 

Have the Configuration Documentation Sheet available as described in 
Chapter 3. 


6.1.2 Software 


It is assumed that: 


The installation of SIPO/ZE 3.1 and ACF/VTAM is completed as described in 
Chapter 4. | 

First Time Users or former BTAM-ES users have copied all ACF/VTAM defi- 
nition books from the SAMPLIB to the ADMINISTATOR Lib as described in 
Chapter 4. 

The CICS/VS-VTAM tables may be also prepared as mentioned there. 


6.1.3 Networking Considerations 


MAXSUBA 


A network address is a sixteen bit field consisting of a subarea field and 
an element field. The number of bits allocated to each is determined by 
the ACF/VTAM start option MAXSUBA. This specifies the maximum address of a 
subarea in the network, a subarea being a host processor or a communi- 
cation controller. 


MAXSUBA must be defined the same in every ACF/VTAM start deck in the net- 
work Cand in each NCP generation), and no subarea address may exceed MAX- 
SUBA. 


The default is 15; the minimum is 3 and the maximum is 255. 


When selecting a MAXSUBA value, keep in mind the number of subareas which 
the network will eventually have, not just the current number. 


In a multi-systems environment with a small number of subareas, it is rea- 


sonable to allow the MAXSUBA to default to 15, as this provides for some 
growth in the network. In addition, when an ACF/VTAM trace is done, the 
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four bits allocated to the subarea will form a hex digit, and the remain- 
ing twelve bits allocated to the element will form three hex digits for 
easy identification. Howaver, other considerations might require another 
selection for MAXSUBA (€ e.g. 31, 63 ), for example, reservation of spare 
subarea addresses. 


SSCPID 
The SSCPID of each ACF/VTAM in a multi-domain network must be unique. 


MAXBFRU, LFBUF SIZE 


On INN CCA) links, both sides must provide for the biggest RU in the net~- 
work. The values on both sides have not to be the same, but they have to be 
selected in a way that both sides can accommodate the biggest RU. 


SUBAREA 


The address of each subarea in a multi-domain network must be unique. 


6.1.4 Naming Conventions 


Before you start with any ACF/VTAM or CICS/VS definitions you should 
choose your naming conventions. Some possible conventions can be found in 
Appendix B of this document. 


6.1.5 Session Initialization 


After an LU Capplication or terminal) has been activated (i.e. the SSCP-LU 
session exists) it can attempt to initiate a session with another LU by 
using an Initiate request Ctlogon')., 
Four types of logon are possible, depending on the source of the logon: 
® Secondary logical unit (SLU) initiated, 
where the secondary logical unit (terminal) issues a request that 
causes it to be logged on to the selected application program. 
This is done by the LOGON command send from the terminal. 
ACF/VTAM can receive logon commands in 


_ field-formatted or 


~ unformatted (character coded) form. 


Field-formatted Initiate requests can be sent by some programmable 
SNA terminals CIBM 8100, IBM 3600, etc.). 
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Most of the terminals described in this primer use the unformatted 
n 2ques’ which is formatted by USS (CUnformatted System 
Servi coal. a component of the SSCP. 


The unformatted (character coded) logon command entered by the termi- 
nal operator has the following format: 


LOGON APPLIDCapplname) <LOGMODECnamed>< DATACUusSerdata)> 
The parameters included between < > are optional. 


APPLIDCapplname) ==> Specifies the name of the application program 
with which a session is to be established 


LOGMODECname) ==> Selects a set of sassion parameters Coptional) 


DATACuserdata) ==> Data to be made available to the application 
program's LOGON exit routine Coptional) 


® Application program initiated, 
where an application program CCICS/VS) requests a session with a sec~ 
ondary logical unit. | 
For example, if CONNECT=AUTO is coded in the CICS/VS TCT TYPE=TERMINAL 
macro a logon request will be issued by CICS/VS for the logical unit 
related to the terminal defined in this macre. 
The secondary logical unit must be powered on, otherwise CICS/VS sets 
this terminal OUT OF SERVICE. 


Do not use CONNECT=AUTO and LOGAPPL=applname (see below) together. 


e@ Automatic logen, 

where ACF/VTAM automatically logs on a secondary logical unit to an 
application program, indicated by coding LOGAPPL=applid in the 
ACF/VTAM LU definition statement. 


°® Operator logon, 
where the operator can cause a specified logical unit to be logged on 
to a specified application program. 
This is done by a: 


V NET, ID=lu-name, LOGON-applname 


entered at the system console. 


In a multi system environment use the SLU initiated technique for keyboard 
terminals. The terminal operator chooses the corresponding application 
in the Logon command. To assist the terminal operator you should provide 
an USSTAB which should contain entries for all applications he can logon 
to. 

See section: "User Defined ACF/VTAM Tables’ for more details. 


For terminal printers or terminals without keyboard €e.g. IBM 3646) 
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use the operator logon technique or the applicatio rogram initiate 
techni que. 


6.1.6 Session Paramaters 


When an LU requests a session with an application program, ACF/VTAM needs 
to know a set of session parameters (session protocol), which govern the 
session. These parameters, also called ‘logon modes’, specify the SNA 
protocol that will be used during the session as well as certain charac” 
teristics of the terminal, such as RU size. 


Usually ACF/VTAM gets these session parameters from a logon mode table. 
However, if CICS/VS is the PLU, it delivers these session parameters to 
ACF/VTAM from own parameters (Ce.g. RUSIZE, etc.) in the CICS TCT macro 
TYPE=TERMINAL. 


ACF/VTAM contains an IBM-sSupplied default LOGMODE table CISTINCLM). This 
table contains several entries of ganerally accepted session parameters 
for a basic list of IBM device types. 


As only the most common terminals are reflected in this table, the user 
may have to provide another LOGMODE table containing the session parama- 
ters for additional terminals. 


In order to select a specific logon mode entry for a specific terminal, 
the names of the table and of the entry must be specified in the terminal 
ACF/VTAM definition for the terminal. 


The LOGMODE table is specified in the MODETAB parameter and the entry of 
this table in the DLOGMOD parameter. These parameters can be coded in the 
LU, TERMINAL or LOCAL macro or ina higher node. 


If MODETAB is not specified, the default LOGMODE table ISTINCLM will be 
searched for the specified entry. 


If DLOGMOD is not specified, the first entry of the selected mode table 
Cuser or default) is used for the session initialization. 


To create a user LOGMODE table refer to section 'User Defined ACF/VTAM 
Tables'. | 


For more details refer to ACF/VTAM V2 Planning and Installation Reference, 
Chapter 18. 


Recommendations for the Usage of a MNODETAB 


CICS/VS 


If CICS/VS is the only application that a terminal will log on to, gener- 
ally there is no need to reference an entry CDLOGMOD) in an ACF/VTAM logon 
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mode table (MODETAB), as CICS/VS provides the session parameters to 
ACF/VTAM from its own definitions. 

Exceptional cases, however, might require a reference to a user logon mode 
table entry Ce.g. IBM 3645 attended/unattended mode). 


To override the CICS/VS provided session parameters, you have to 
e specify LOGMODE-entry name in the CICS/VS TCT TYPE=TERMINAL macro, 


° code your own logon mode table as shown in section: ‘User Defined 
ACF/VTAM Tables’. 


® specify the logon mode table name in the MODETAB parameter of the 
ACF/VTAM terminal definition. 


e code DLOGMOD-entry name in the ACF/VTAM terminal definition 
Coptional, for documentation purposes only). 


NCCF 


If the terminal can also be connected to NCCF you have to provide a LOG- 
MODE table entry with the name DSILGMOD for this terminal. 

Prepare a user logon mode table for this terminal as shown in section 'Us- 
er Defined ACF/VTAM Tables’. 


If the terminal is working only with CICS/VS and NCCF, the LOGMODE table 
has to contain only the entry DSILGMOD and only MODETAB='user table name' 
has to be specified in the terminal's definition. 


GCther Applications 


In a multi system environment with several ACF/VTAM applications such as 
IMS/VS, 150, the session parameters have to be supplied via a logon mode 
table antry. 


In this case, it is recommended that the necessary table entry name for 
each session be provided in the LOGON command: 


Prepare a USSTAB with specific LOGON commands for each application and 
define the LOGMODE table entry name in the LOGMODE parameter of tha USS 
command CUSSPARM PARM=LOGMODE, DEFAULT=entryname). 


Check the default table ISTINCLM to see if the session parameters for ter- 
minal are specified or not. If the terminal has an entry in ISTINCLM, you 
just need to specify this entry name in the DLOGMOD parameter. If not, 
you need to prepare your own logon mode table. 
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6.1.7 Session Termination 


When one session partner decides to terminate the communication, it can 
request a session termination. The method by which this is done varies 
according to which end of the session wants to terminate it. 


Three types of session termination are possible, depending on the source 
of the termination request: 


SLU requested session termination, 

Where the secondary logical unit (terminal) issues a termination 
request that causes it to be logged off from the application program. 
Session termination is requested from SLUs if it sends the LOGOFF con- 
mand. To be able to enter a character-coded LOGOFF command, this ter- 
minal has to be in the SSCP-LU session. This is achieved by hitting 
the SYSREQ key on an SNA terminal Cthis is not possible on a non-SNA 
terminal). 


The LOGOFF command can have parameters to indicate to ACF/VTAM whether 
the request is for conditional or unconditional termination of the 
session. 


If conditional termination is requested ACF/VTAM notifies the appli- 
cation program that the secondary logical unit has requested that the 
session be terminated. The application program can ignore the request 
or issue a CLSDST macro instruction to terminate the session. 


If unconditional session termination is specified, ACF/VTAM termi- 
nates the session and then notifies the application program that the 
session has been terminated and that it is to issue a CLSDST macro 
instruction. 


The format of the LOGOFF command is: 
LOGOFF <APPLIDCapplname)> <TYPECCOND|UNCOND] FORCE)> <HOLDCYES]NO)> 
The parameters included between < > are optional. 


APPLIDCapplname) ==> Specifies the name of the application program 
with which a session is to be terminated 


TYPECCOND]|UNCOND| FORCE) 
| ==> Specifies the type of LOGOFF as conditional or 
unconditional or forced. 
The default value is unconditional. 


HOLDCYES|NO) ==> Specifies wether or not the LU expects ACF/VTAM 
to maintain the SSCP-PU session. 
The dafault value is yes. 


Application program requested session termination, 


where an application program Ce.g. CICS/VS) requests session termi- 
nation with a secondary logical unit. 
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In case of CICS/VS this kind of request can be also initiated by the 
connected terminal or the master terminal operator as shown below. 


For example, the terminal operator enters the CICS/VS command CSSF 
LOGOFF at a terminal in session with CICS/VS; or the master terminal 
operator enters one of the following commands: 


CSMT CLOSE,VTAM (for all connected terminals) 
CSMT SHUT,NO (for all connected terminals) 
CSMT TER,SIN,... (for a specific terminal). 


After these commands the terminal(s) are again in the SSCP=LU session 
and ACF/VTAM LOGON commands can be entered at the terminal. | 


Operator requested session termination, 

where the ACF/VTAM operator can cause a specified logical unit to bea 
logged off from a specified application program. This is done by 
entering V NET,TERM,ID=Luname at the system console. 


Also V NET, INACT,ID=luname has the same effect, as it will terminate 
the SSCP-LU session and therefore also the hierarchically lower LU-LU 
session. 


Usually the application program requested session termination is used. 
That means, many applications like CICS/VS, NCCF, etc. allow the terminal 
user or master terminal operator to request session termination via opera~ 
tor commands. 

In special situations the other types of session terminations may be used. 
Conclusion 

At this point you should have determined which 

e subarea number in your domain, 

6 MAXSUBA in your network 

° haming conventions, 

e LOGON/LOGOFF procedures, | 

® session parameters, 


are usad. 


Now you are ready to make your VSE, ACF/VTAM and CICS/VS definitions for 
your domain. 7 


During the customization use your Configuration Documentation Sheet and 
fill in the missing values. 
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6.2 IYPL/JCL DEFINITIONS 


Go to Chapter 5 and make the definitions as shown there. 
Return and continue with the next steps. 


6.3 ACF/VTAM DEFINITIONS 


6.3.) User Defined ACF/VTAM Tables 


In addition to cataloging books to define an ACF/VTAM network, tables 
related to the LU-LU session establishment may need to be cataloged, such 
as logon mode tables and USS tables since the defaults provided are not 
always adequate. 


User Logon Mode Tables 


Logon mode entries are defined in logon mode tables, which are assembled 
and link-edited into phases. A table is defined with a MODETAB macro, and 
entries follow, each one defined with a MODEENT macro. The table ends 
with a MODEEND macro. 


The entries are selected by: 


1. a MODETAB parameter on the LU or TERMINAL macro for the terminal con- 
cerned, which points to the logon mode table in which the entry is 
contained. 


2. a DLOGMOD parameter on the LU or TERMINAL macro for the terminal con- 
cerned, which identifies the entry in the logon mode table. The entry 
can alternatively ba specified in the USS logon command. If both are 
specified, the USS command will override the DLOGMOD parameter. 


Note: 

The MODETAB and DLOGMOD parameters may be specified on a higher macro 
Ce.g. PU, CLUSTER, LINE, GROUP) and this will "sift*® down to LU and TERMI- 
NAL macros. A sifted macro can then be overridden by a specific macro on 
any particular LU or TERMINAL. 


Recommendations 

If you are only using CICS/VS ACF/VTAM applications, then it will not nor- 
mally be necessary to code logon mode tables as CICS generates its own 
SeS5Sion parameters from the TCT definitions. If you are using other 
ACF/VTAM applications it may be necessary; it is required by NCCF. 
Examples of how to code tables for NCCF are given below. Where NCCF is 


used, it is necessary to cede a table for each class of device with an 
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entry (MODEENT) of 'DSILGMOD’ in each table (this name is required by 
NCCF). The tables may, of course, contain other entries not used by NCCF. 
It is suggested that three tables be coded as follows: 


Name Use 

MODLUO Non-SNA displays and printers 
MODLUI SNA printers 

MODLU2 SNA displays 


The jobs te generate these tables are as follows: 


1. Table MODLUO !? ~ 
/7 JOB MODGENO ASSEMBLY AND CATALOG A MODETAB 
7/7 LIBDEF CL,TO=USRCLI 
// LIBDEF SL,SEARCH=PRDSLG 
77 OPTION CATAL 
PHASE MODLUO,* 
“7 EXEC ASSEMBLY 
MODLUO MODETAB 
DSILGMGD MODEENT LOGMODE=DSILGMOD, X 
FMPROF=X'02",TSPROF=X'02',PRIPROT=X'71', 
SECPROT=X'40", COMPROT=X'2000' ,RUSIZES=X'0000', as 
PSERVIC=X* o00000000000000000000200' 


*«K 


MODEEND 

END 
7% 
ff EXEC LNKEDT 
7% 


2. Table MODLUI ?° - 
// 308 MODGENI ASSEMBLY AND CATALOG A MODETAB 
// LIBDEF CL,TO=USRCLI 
// LIBDEF SL,SEARCH=PRDSLG 
ff OPTION CATAL 
PHASE MODLUI,* 
// EXEC ASSEMBLY 
MODLUI MODETAB 
DSILGMOD MODEENT LOGMODE=DSILGMOD, * 
FMPROF=X'03',TSPROF=X'03",PRIPROT=X'B1', 
SECPROT=X'A0' ,COMPROT=X"3080',RUSIZES=X'8587', % 
PSERVIC=X'O01000000E100000000000000' 


x 


MODEEND 

END 
7% 
// EXEC LNKEDT 
1% 


3. Table MODLU2 1° - : 
// JOB MODGEN2 ASSEMBLY AND CATALOG A MODETAB 
// LIBDEF CL,TO=USRCL1 
// LIBDEF SL,SEARCH=PRDSLG 
// OPTION CATAL 
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PHASE MODLU2,x* 
47 EXEC ASSEMBLY 
MODLU2 MODETAB 
DSILGMOD MODEENT LOGMODE=DSILGMOD, x 
FMPROF=X'03",TSPROF=X'03',PRIPROT=X'B1', | 
SECPROT=X"A0'",COMPROT=X'3080* ,RUSIZES=X'3787', oS 
PSERVIC=X'020000000000000000000200' 


* 


MODEEND 

END 
7% 
// EXEC LNKEDT 
7% 


User USSTAB 


When the terminal operator initiates the LU-LU session Cas on a 3270 
screen), a USSTAB (Unformatted System Services Table) is used by Unformat- 
ted System Services. 

One is provided with ACF/VTAM and others can be defined by the user. USS, 
a component of the SSCP, converts character-coded commands coming from a 
terminal operator or the domain operator to a field-formatted form. This 
enables the logon procedure to be simplified to allow, for example, the 
entry of a single word froma terminal to perform the logon to an applica- 
tion. 


The IBM-supplied USS table CISTINCDT) is used if no other is identified in 
the ACF/VTAM definitions. 


The USS table allows you to modify the USS messages that are sent to the 
terminal. This could be used to provide information to the terminal opara- 
tor about logon procedures, for example. 


The table is identified by the USSTAB parameter on the LU, LOCAL or TERMI- 
NAL macros. It can also be ‘sifted’ from a higher level macro as for the 
macros describing the logon mode table (see previous section). 

The table contains definitions for: 


e LOGON command format and defaults 

e IBMTEST command format and defaults 

° LOGOFF command format and defaults 

e USS messages definitions for messages 1 to 9 and 12, 13. 


These messages are sent when error conditions are detected by ACF/VTAM 
during the LOGON process. 


19 The definitions supplied here are for printers and single size 


screens attached to 3274s. For multiple size screens and devices 
attached to a 3276, see the session parameter table in the NCCE 
Installation manual. 
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@ A character translation table definition that will accept EBCDIC 
characters and convert lowercase letters from 'a' to 'z' to uppercase, 
horizontal tab characters to blanks, leaving all other characters 
unchanged 


The dafault USSTAB does not include entries for message 0 and message 10 
which could be used to indicate to the terminal operator the status of the 
SSCP-LU or LU-LU session. 

A detailed description of the USS table provided by ACF/VTAM can be found 


in the ACF/VTAM V2 Planning and Installation Reference Manual, Chapter 18. 


A user USS table for terminal users is supplied with SIPO/E 3.1 in the 
SAMPLIB (member USSTAB). This table has entries defined for all of the 
USS messages to provide the terminal operator with information on the 
state of the session. 


The first USSCMD entry in the table is a group of macros which modifies 
the USS LOGON command. It is recommended that you remove these and allow 
the LOGON command to default. 


The tables are assembled, Link~edited and cataloged into a VSE Core Image 
Library, so that they are available to ACF/VTAM. 


Shortened LOGON Commands 


You may expand this USSTAB with shortened LOGON commands to allow the user 
to enter a single word to access the desired application (e.g. CICS1 or 
NCCF60, etc.). 


The following JCL stream and ACF/VTAM definition statements generate such 
a USSTAB for IBM 3270s. 


7/7 JOB USSTAB CATAL USSTAB 
“7/7 LIBDEF CL,TO=USRCL1 
// LIBDEF SL,SEARCH=PRDSLG 
// OPTION CATAL 
PHASE USSTAB,X 
/7 EXEC ASSEMBLY 
PEPE SESE SESS SESE SS EPPS SETS EPSPS STS EPSPS ESS SESS SL ESSELESE SSS ESSE SESS ESS SY 


x % REF. TO SIPOQ/E 3.1 SAMPLIB MEMBER USSTAB 
HE 3 HEE DEE KDE EEE DE HE EHEC HK DE IE DK DEDEDE DE DE HE DE IE DE 3 DE DE DE DE DE HE DE DK DK IE DE DE DE I DK IEDC DE DE NE DE DE DE DE IE DE DE DK DE DEE EEE 
EJECT 


USSTAB USSTAB 


3 DEH HEHE EEE HK HE DE HEHE HE DEH DEE EEE DE DEE HE HK IE DE IE HE DE IC DC DE DE DE HE IE DE HE 3 DE IE DE DK HE DE DK IC DC OK DE DK DE DEK IE DE DK EEE ME 
x REMOVE THE MODIFIED LOGON COMMAND FROM HERE % 
PEP S SESE PS SELECT ESL SS SESS ESE PSE S SESE SESS SPS PES SE SSS EPS S ES SESS SES eS SSS 
HE HEE HE DE DE 3E DE HK HE DE IE DE DE DE DE DE DE DE DE DE DE HE DE DE DE DE DE DE IE IE DK EN HK DE IKE IK DE DEE DK HK HE DE DK IE 3 OK DEE DK DEK EOE OK IE DEK HK OEE 
% SAMPLE FOR SHORTENED LOGON COMMANDS % 
% FOR CICS CA60CICS1) and NCCF CAGONL) % 
DE DE EE HE DEEN DEE DICH HE HE DE DE DE HEHE DE IE EE DE DENK DE DE IEE IK HE DE DG DHE DEDEDE I DE IE DE DEDEDE DE DE DE DE DE DK DE DE IE DE DK OK DED KEE 
CIcsl USSCMD CMD=CICS1,FORMAT=BAL,REP=LOGON 
USSPARM PARM=APPLID,DEFAULT=A60CICS1 
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USSPARM PARM=LOGMODE 
| USSPARM PARM=DATA 

NCCF60 USSCMD CMD=NCCF60,FORMAT=BAL,REP=LOGON 

USSPARM PARM=APPLID,DEFAULT=A60N1 

USSPARM PARM=LOGMODE 

USSPARM PARM=DATA 
MSGO USSMSG MSG=0,TEXT="USS COMMAND SUCCESSFULLY COMPLETED’ 
MSGI USSMSG MSG=1,..... 
MSG10 USSMSG MSG=10,TEXT="CONNECTED TO SA 60 ENTER LOGON COMMAND" 
END USSEND 

END 
/¥* 
7/7 EXEC LNKEDT 
i 
1% 
* $$ EOJ 


Note: 

It is suggested that you provide in the text of MSG10 the system identifi- 
cation or subarea number. 

After MSG10 is displayed on the screen, the terminal user types in 
"CICS1", then ACF/VTAM will sand MSGO and establishes the LU-LU session 
with the application A60CICS1 which sends the Good Morning Message. 


This table is valid for SNA and non-SNA 3270s. It provides only one-lina 
messages on the screen. 


Expanded USS Messaces 


You may want to supply more information to the terminal operator. Partic~- 
ularly, MSG10 could have more terminal operator guidance than the SIPO/E 
3.1 sample. MSG10 corresponds to a message that is automatically sent to 
a logical unit whenever it is available for use, such as when it is acti- 
vated or a user issues a LOGOFF command or hits the SYSREQ key. 


Ensure that the message length is less than or equal to the buffer size of 
the SNA device. For remote 3274s, 32765 and 8775s (Ci.e. remote SNA 
devices), this is 256 bytes of RU. For local SNA devices and remote 
non-SNA devices, this is the full screen size. 


If you want to exploit the maximum message length, you should code three 
different USS tables for the different device typas. 


A specific table is selected by specifying USSTAB=phasename in the minor 
node. 


If a USSTAB is specified that can not be found by ACF/VTAM Ce.g. not cata-. 


loged or wrong CL SEARCH sequence in F3), the ACF/VTAM default USSTAB CIS- 
TINCDT) is used. 
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If you change an existing USSTAB in the CL, ACF/VTAM has to be stopped and 
restarted before the new table can be used. | 


The sample below shows how a MSG10 is aexpanded for a Non-SNA IEM 3270. 
These definitions are valid for a model 2 (24 x 80)screen. 


Modify the SIPO/E 3.1 sample in the following manner: 

Change 

e the phase name in PHASE card to USSNSNA 

° the label in the USSTAB macro to USSNSNA 

e the MSGLO definition into : MSG10 USSMSG MSG=10,BUFFER=M10 


Insert between the USSEND macro and the END macro: 


M10 DC AL2CM1O0END-M10~-2) 
DC X'F5! ERASE WRITE 
DC X'C7? WCC ALARM 
DC X°114040' BUFFER ADDRESS 
DC CL380* * 
DC CL&0!° SA 61° 
DC CL&0' SYS6! 
DC CL8C! RALYDPD6' 
DC CL&ao'" ' 
DC CL80' TYPE IN REQUIRED APPLICATION’ 
DC CL30* ° 
DC CL80* * 
DC CL8O* * 
DC CL80° AND PRESS ENTER’ 
DC CL80" ° 
DC CL80* * 
DC CL8O' FOLLOWING APPLICATIONS ARE AVAILABLE’ 
DC CL&8o' * 
DC CL8o0" * 
DC CL80" APPLICATION APPLID TYPE IN’ 
DC CL8O' ° 
DC CL80°' CICS RALEIGH A60CICS1 CIcsi' 
DC CL8&0' CICS MUNICH A61CICS1 cics2' 
DC CL&0!t CICS MELBOURNE A62CICS1 CICS3' 
DC CL8&0° IMS CARACAS A1LIMS1 IMS! 
DC CL80' TSO CARACAS A11TSO1 TSO* 
DC CL80" * 
DC X'1D4013!' 
DC CL73! ! 
DC X'1DFO! 


MISEND EQU xX 


The second sample shows how a MSG10 is expanded for an local SNA IBM 3270. 
These definitions are valid for a model 2 (24 x 80)screen. 


Raleigh Intarnational Systems Center 


Modify the SIPO/E 3.1 sample in the following manner: 


Change 


e the phase name in PHASE card to USSLSNA, 


e the label in the USSTAB macro to USSLSNA, 


e the MSG10 definition into : 
USSMSG MSG=10,BUFFER=M10. 


MSG10 


Insert between the USSEND macro and the END macro: 


M10 DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 


MIOEND EQU X 
END 


AL2CM10END-M10-2) 


X*4015' 
X'4015' 
CL&0' 
CL&0' 
CL3&0° 
X'&015* 
CL&0! 
X'4015° 
X'4015' 
X'4015' 
CL80° 
X'4015!' 
X'4015' 
CL80" 
X'4015!' 
CL&0° 
X*4015" 
CL80' 
CL80°' 
CL380° 
CL380' 
CL80° 
X'4015° 


SA 61' 
SYS6' 
RALYDPD6* 


TYPE IN REQUIRED APPLICATION’ 


AND PRESS ENTER‘ 


FOLLOWING APPLICATIONS ARE AVAILABLE’ 


APPLICATION APPLID TYPE IN* 
CICS RALEIGH A60CICS1 CIcsi' 
CICS MUNICH A61ciIcsl CIcs2' 
CICS MELBOURNE A62CICS1 CICS3' 
IMS CARACAS ALLIMS1 IMS* 
TSO CARACAS AL1TSO1 TSO° 


The third sample shows how a MSG10 is expanded for an ramote SNA IBM 3270. 
These definitions are valid for a model 2 (24 x 80)screen. 


Modify the SIPO/E 3.1 sample in the following manner: 


Change 


e the phase name in PHASE card to USSSNA, 


° the label in the USSTAB macro to USSSNA, 


° the MSG10 definition into :; 
USSMSG MSG=10,BUFFER=M10. 


MSG10 
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Insert between the USSEND macro and the END macro: 


M10 DC AL2CM1O0END-M10~-2) 


DC X*4015' 
DC X'4015' 
DC CL80' Enter IBMTEST or logon command :! 
DC CL80* CICS1 CIcS2 CICS3 IMS TSO' 
MIOEND EQU x 
END 
Note: 


Each skip new line command (X'4015') represents a separate line. After 
this panel is displayed, the cursor is located in line 24 for the first 
two examples, and line 4 for the the third example. 


6.3.2 Local and Remote Devices 


Now define the ACF/VTAM major and minor nodes in your subarea. 


Go to Chapter 5, section "Local and Remote Devices’? and use the same defi- 
nitions. 


The only changes to make are: 
© use the selected naming conventions, 


© remove LOGAPPL=DBDCCICS for devices which will require access to mul- 
tiple applications, 


* add USSTAB=phasename Cif desired; see 'User Defined ACF/VTAM Tables’) 


° add MODETAB=phasename and DLOGMOD=entryname Cif neccessary, see "User 
Defined ACF/VTAM Tables'*) 


6.3.3 ACF/VTAM Application Programs 


Use the same definitions for the applications running in your subarea as 
shown in the Chapter 5. 


The only changes are: 
® the naming conventions selected, 


® addition of special application to application session parameters, 
for example if CICS/VS-ISC or NCCF-NCCF sessions are planned. 


Return and continue with the next steps. 


102 


Raleigh International Systems Center 


6.3.% PEER to PEER Link 


A line from an IBM 4331 CA to another IBM 4331 CA is called a PEER to PEER 
link. This Line must be a non-switched Cleased) SDLC line. However, it is 
possible to use modems with the SNBU feature to provide a switched line 
which appears to each end as leased line. See Chapter 7 for details. 


Define a separate CA major node for this line or expand your existing CA 
major node. 


The following JCL stream and ACF/VTAM definition statements may be used to 
catalog a separate CA major noda for a PEER to PEER link. 


// JOB N6021CAT CATAL CA Major Node N6021 
// LIBDEF SL,TO=USRSLI 
// EXEC MAINT 
CATALS B.NG6O21]1 
BKEND B.N6021 
N602] VBUILD TYPE=CA 


G601 GROUP LNCTL=SDLC, x 
DIAL=NO 25 | 

L60032 LINE ADDRESS=032,2° x 
RETRIES=7 

P60032 PU PUTYPE=5, 23 x 
SUBAREA=6 122 

BKEND 
f% 
7% 


A line from an IBM 4331 CA to an IBM 3705 is called an upstream link. This 
line must be a non~-Sswitched (Cleased) SDLC line. As for the PEER to PEER 
link, modems with the SNBU feature may be used to provide a switched line 
which appears as a leased line. 


Define a separate CA major node for this line or expand your existing CA 
major node. 


The following JCL stream and ACF/VTAM dafinition stataments are used to 
catalog a separate CA major node for this type of link. 


29 The channel unit address for the line. 
21 PUTYPE 5 must be specified for another IBM 4331 
22 The destination subarea address of VTAM in the other IBM 4331 


Chapter 6: Multi System Environment 103 


Raleigh International Systems Center 


/f JOB N6031CT CATAL CA Major Node N6031 
// LIBDEF SL,TO=USRSL1 
// EXEC MAINT 
CATALS B.NG6O31 
a BKEND B.N6031 
N6031 VBUILD TYPE=CA 


G601 GROUP LNCTL=SDLC, * 
- DIAL=NO 25 

L60032 LINE ADDRESS=032,24 % 
RETRIES=7 

P60032 PL PUTYPE=4,25 x 
SUBAREA=1426 

BKEND | 
4X 
7% 


6.3.6 PATH Tables 


s neiataminedinaianemaiaad 


A path table is necessary to define the path between various domains. 
Routing information must be provided to ACF/VTAM when a session is estab- 
lished between logical units in different subareas. This routing informa- 
tion is provided to ACF/VTAM through the PATH macro which the user must 
dafine and catalog in a VSE source statement library. 


The following is an example of how to define and catalog a PATH table for 
routes over a PEER to PEER link: : 


ff JOB ¥V601CT CATAL PATH TABLE 
f/f LIBDEF SL,TO=USRSLI 
f/f EXEC MAINT 
CATALS B.V601 
BKEND B.¥601 


V6061 PATH DESTSA=61, % 
ERO=(61,1),2? * 
¥RO=028 

BKEND — 

7% 

1% 


The following is an example of how to define a PATH macro for an upstream 
Link to an IBM 3705 attached to an IBM 4341 or IBM 30XX processor. 


#3 DIAL=NO must be specified or defaulted for a PEER to PEER link. 

24 The channel unit address for the line. 

75 PUTYPE 4 must be specified for an IBM 3705 

26 The subarea number of the NCP 

2? The first subparameter of ERx defines the adjacent subarea number, the 
second the transmission group. 
In the case of a connected IBM 4331 the adjacent subarea number 15 
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V6011 PATH DESTSA=(11,14),?°% x 
ERO=(14,1),%° pS 
VRO=0%2 


6.3.7 Cross-Donmain Definitions 


The Cross-Domain Resource Manager Definition 


A cross~domain resource manager (CDRM) is a portion of the System Services 
Control Point (SSCP) that controls cross-domain sessions. A CDRM Major 
Node is defined with a VBUILD TYPE=CDRM definition statement, and each 
minor node is defined with a CDRM definition statement. For each domain 
one CDRM has to be defined. 


The CDORM major node 


The following example shows the definitions in subarea 60 of the own CDRM 
and the two CDRMs in subarea 11 and 61. 
// JOB M601CAT CATAL CDRM MAJOR NODE 
//7 EXEC MAINT 
CATALS B.M6901 
BKEND B.M601 
M601 VBUILD TYPE=CDRM 
M6060 CDRM SUBAREA=60,CDRDYN=YES,CDRSC=O0PT 
M6061 CDRM SUBAREA=61,CDRDYN=YES,CDRSC=OPT 
M6011 CDRM SUBAREA=11,CDRDYN=YES, CDRSC=OPT 
BKEND 
7% 
1% 


equal to the destination subarea number. The transmission group is 
always 1 for a link ona CA. 

If the connected subarea is a migration node CIBM 4331 with 
ACF/VTAME), ERO must be specified. 

There is no PATH macro definition necessary in the migration node. 

*6 If the connected subarea is a migration node CIBM 4331 with 
ACF/VTAME), VRO must be specified. 

29 Indicates the subarea number(s) of the destination subarea(s). More 
than one destination subarea can be specified for each adjacent sub- 
area. The destinations are an NCP (subarea 14) and a host (subarea 
11). 

$9 The adjacent subarea number is the NCP's subarea number. 

If the connected subarea is a migration node CACF/NCP R. 2.1, and ear- 
lier releases), ERO must be specified and the transmission group is 
always 1 for a link ona CA. 

41 If the connected subarea is a migration node CACF/NCP R. 2.1, and ear- 
lier releases), VRO must be specified as shown above. 
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SUBAREA=nn represents the subarea number of the host in which the CDRM 
7 represented by this statement resides. 


CDRDYN=YES (on M6060) authorizes the CDRM to dynamically define a 
cross-domain resource. E.g., a terminal in subarea 11 or 61 
can log on to an application in subarea 60 without being 
defined as a cross-domain resource in subarea 60. The appli- 
cation, however, has to be defined as a cross-domain resource 
in subareas ll and 61. | 


CORSC=YES Con M6061 and M6011) authorizes the CDRMs in the other sub- 
areas to dynamically define cross-domain resources. The 
application in subarea 61 or 11 has to be defined as a 
cross-domain resource in subarea 60. 


he Cross~Remain Resource Definitia 


A Cross~Domain Resource (CDRSC) is an application program or logical unit 
in another domain that is available for use by resources in this ACF/VTAM 
domain. Each CDRSC major node is defined with a VBUILD TYPE=CDRSC defi- 
nition statement, and each minor node is defined with a CDRSC definition 
statement. 


The CPRSC Maser Noda 
j 


The following example shows the definitions in subarea 60 of the applica- 
tions TSO and IMS which reside in subarea 11 and to which resources from 
subarea 60 can log on. 


// JOB R6011A11 CATAL CDRSC MAJOR NODE 
77 EXEC MAINT 
CATALS B.R6011Al1 
| BKEND B.R6011A11 
R6011A11 VBUILD TYPE=CDRSC 
A11TSO1 CDRSC CDRM=M6011*? 
ALLIMS1 CDRSC CDRM=M6011 
| BKEND 
7% 
7 & 


Ss2 The label A117TSO1 must be the same as the name specified in the APPL 
statement in the other domain. 
M6011 specifies the name of the CDRM that controls this resource. 
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6.3.8 Dafinitions at the ACF/NCP Site 


The following example shows the ACF/NCP (subarea 14) definitions for a 
downstream link to an IBM 4331: 


x KK KK K K KOK OK OK OK 


NCPBUILD BUILD ABEND=YES, ABEND FACILITY INCLUDED ¥ 
BFRS=128, NCP BUFFER SIZE % 
CA=C(CTYPE4,TYPE4-1), INSTALLED CHANNEL ADAPTER TYPE x 
a % 
MAXSUBA=127, ALLOW FOR UP TO 127 SUBAREAS ¥ 
hassel ahi Es ae 79 ¥ 
MODEL=3705-2, CYCLTIME=900 FOR 3705 J iS 
SUBAREA=14, SUBAREA ADDRESS = 14 % 
TYPGEN=NCP, NCP ONLY x 

M11 HOST INBFRS=10, NCP BUFFERS ALLOCATION * 
UNITSZ=152, VTAM IO BUFFERS SIZE X 
SUBAREA=(11), CHANNEL ATTACHED HOSTSA REL 3 % 

| TYPE=TYPES TYPE 3 COMM SCANNER 

PATH DESTSA=11, x 
ERO=C11,1) 

PATH DESTSA=60, % 
ERO=(€60,1),ER1=(€61,1) 

L140A2 LINE ADDRESS=0A2, TRANSMIT AND RECEIVE ADDRESSES 
CLOCKNG=EXT, MODEM PROVIDES CLOCKING 
DUPLEX=FULL, MODEM STRAPPING IS FULL 
INTPRI=2, INTERRUPT PRIORITY 
MONLINK=YES, MONITOR LINK FOR ACTPU 
NEWSYNC=NO, 

NRZI=YES, 

PAUSE=0.1, 

SDLCST=CSDLI4PRI,SDL1I4SEC), 

SERVLIM=254, 

SPEED=4800, LINE SPEED IS 4800 BPS 
SRT=(,64), 

ISTATUS=ACTIVE INITIAL STATUS 

HH HH HEHE HK HEHE HK HK HE KE KE EK IE HK I EE EK EK KK HEH EH HK EK EK HK KEK EH KE HK HK HE HK HEH EK HK HK HH HK HE KH KH KK 

x PU MACRO SPECIFICATION FOR THE ADJACENT 4331 SA=60 x 

P140A2 PU MAXOUT=7, MAX PIU'S SENT BEFORE RESP RE@ % 
PUTYPE=4, PHYSICAL UNIT TYPE "LOCAL 3705' x 
ISTATUS=ACTIVE, INITIAL STATUS | % 
TGN=1, | TRANSMISSION GROUP 1 (€4331-ICA) % 
ANS=CONTINUE DON'T BREAK THE X-DOMAIN SESSIONS 


Note: 

The PU macro describes the IBM 4331. | 

The transmission group number CTGN=1) has to match the TGN specified in 
the PATH macro of subarea 60 which points to the NCP (subarea 14). 
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6.3.9 Selecting ACF/VTAM Start Options 


The Start List 

All recommendations given in Chapter 5 about this subject are also valid 
in a multi-system environment. 

However, your start list ATCSTROO should contain the following 
parameters: 

SSCPID=xx, 

HOSTSA=xx, 

MAXSUBA=yy, 

Note: 

SSCPID and HOSTSA should be equal and represent your subarea number. 
MAXSUBA must be the same in all domains. | 


(see: Prerequisites in this chapter) 


Additional start options may ba specified in a book B.ATCSTRxx, where xx 
could be the subarea number of your domain. 


The Configuration List 


Go to Chapter 5 and refer to this subject. 
There are following additional hints: 


The suffix of your ATCCONxx reflects the subarea number. 
The order of the major nodes coded for this B.book should ba: 


Local and remote major nodes, the application major node and then 
the path table, the cross-domain manager and cross-domain resource major 
nodes. 


6.3.10 The ACF/VTAM Start Job 


There is no difference; continue as described in Chapter 5. 


6.4 TEST OF YOUR CUSTOMIZED ACF/VTAM DEFINITIONS 


Make sure that the 
° ASI procedure reflects your network, 


e ACF/VTAM B.books defining your environment are cataloged, 
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e USSTAB(Cs) 7 MODETABCS) are assembled and cataloged Cif necessary in 
your environment), 


° ACF/VTAM startup is submitted, 


@ devices and lines you want to test are not assigned to other parti- 
tions. 


The sequence of starting your network is shown in Chapter 5. 


In addition, if all local and remote devices can be connected to ACF/VTAM, 
tast your PEER to PEER Link and/or upstream link. 


Test each link separately, subarea after subarea, check 
° the physical connection in the concerned domains, 

e the PATHTABs, 

° the CDRMs and CDRSCs. 


The following is an example of a console log showing the initiation of a 
Link to another domain. 


The host system has a subarea address of 61, while tha dastination has a 
subarea address of 60. The line linking the two subareas is known from the 
host as L61032, and its associated link-station is C61032. 


The line, linkstation, CDRMs and CDRSCs are all inactive initially. 


* First, vary the line active 
v net,act,id=161032 

=> 

F3 017 5A97I VARY ACCEPTED 

F3 017 SA93I 161032 ACTIVE 


* Display link stations; note that the line is ACTIV 

¥ but the linkstation is not, yet. | 

d net,stations 

=> 

F3 017 5A97I STATIONS ACCEPTED 

F3 017 5D50I VTAM DISPLAY - DOMAIN TYPE = STATIONS 

F3 017 5D93I PU T4/75 MAJOR NODE: NAME = ISTPUS, SUBAREA = 061 
F3 017 5B72I NO LINK STATIONS EXIST 

F3 017 5SF&84I CA MAJOR NODE: NAME = N611 


F3 017 5D96T LINENAME STATUS LNKSTA STATUS CTG GTG ADJNODE ADJSA 


F3 017 SD97I LO&1032 ACTIV----E C61032 INACT 1 1 7 000 
F3 017 5D14I END 


¥ Activate the linkstation. The link station's status is already 
*% pending contacted from the other domain. 

v net,act,id=c61032 

=? 

F3 017 5A97I VARY ACCEPTED 
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F3 017 5E64I LINK STATION C61032 IS IN CONTACT WITH SUBAREA 60 
F3 017 5A93I C61032 ACTIVE 


 * Display CDRMs - none is active. 
d net,cdrms 


=> 
F3 
F3 
F3 
F3 


017 5A97I DISPLAY ACCEPTED 


017 S5D50I VTAM DISPLAY - DOMAIN TYPE = 


CROSS-DOM. RSRC MGR 


017 5B72I NO CDRMS EXIST 
017 5D14I END 


% Activate CDRM M611. 
v net,act,id=m6l11 


=> 
F3 
FS 
FS 
F3 
F3 


017 
017 
017 
017 
017 


5A97I 
5A93I 
5A93T 
5A93T 
5A93I 


VARY ACCEPTED 
M611 ACTIVE 
M6161 ACTIVE 
ISTCDRDY ACTIVE 
M6160 ACTIVE 


* Now display CDRMs 
d net,cdrms 


=> 
F3 
F3 
F3 
F3 
FS 
F3 


* Now display CDRMs. Note that one is defined for this host - M6161. 


017 
017 
017 


017 


017 
017 


SA9TI 
5D50I 
5A8 91 
5E82I 
5E82I 
5D141 


DISPLAY ACCEPTED 


VTAM DISPLAY - DOMAIN TYPE = CROSS-DOM. RSRC MGR 


M611 TYPE = CDRM SEGMENT » ACTIV 
M6161 ACTIV, SUBAREA = 061 

M6160 ACTIV, SUBAREA = 060 

END 


d net,e,1d=mé6ll 


=>. 
F3 
F3 
FS 
F3 
F3 
F3 
FS 


017 
017 
017 
017 
017 
017 
017 


5A9TI 
5A75I 
5E86I1 
5E771 
5E82I 
5E8e2I 
5D141 


DISPLAY ACCEPTED 


VTAM DISPLAY - NODE TYPE = CDRM SEGMENT 


NAME= M611, STATUS= ACTIV, DESIRED STATE= ACTIV 
CDRMS: 

M6161 ACTIV, SUBAREA = 061 

M6160 ACTIV, SUBAREA = 060 

END 


* Display CDRSCs - none is active yet. 


d net,cdrscs 


=> 
ARS 
F3 
F3 


FS 


F3 


¥ Activate the CDRSC. A60CICS1 is the CDRSC for CICS/VS in subarea 60 


017 
017 
017 
017 
017 


5A9TI 


5D501 
5A89I 


5E83I 
5D14I 


DISPLAY ACCEPTED 


VTAM DISPLAY - DOMAIN TYPE = CROSS-DOM. RESOURCES 


R61601 TYPE = CDRSC SEGMENT » ACTIV 
A60CICS1 INACT » CDRM = M6160 
END 


v net,act,id=a60cicsl 


=> 
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F3 017 5A97I VARY ACCEPTED 
F3 017 5A93I AGOCICS1 ACTIVE 


* Display route to subarea 60 
d net,route,destsub=60 
=> 


F3 017 5A97I ROUTE ACCEPTED 

F3 017 5F35I ROUTE DISPLAY 2 TO SA 
F3 017 5SF36I VR TP STATUS ER 
F3 017 5F37% 0 0 ACTIV 0 
F3 017 5D14I END 


= 60 
ADJSUB 
60 


STATUS 
ACTIV3 


* At this stage, authorized terminals in subarea 61 are able 


¥ to log on to CICS/VS in subarea 60, 


¥ can take place. 
d net,terms,act 


ISTPUS 


i.e. 


cross-domain logons 


LOGICAL UNITS/TERMS 


= H61IL1L1 


LOGICAL UNIT 
LOGICAL UNIT 
H61L21 


=> 

F3 017 5A97I DISPLAY ACCEPTED 

F3 017 5D50I VTAM DISPLAY - DOMAIN TYPE = 
F3 017 5D54I PU T4/75 MAJOR NODE 

F3 017 5D51I LOCAL 3270 MAJOR NODE 

F3 017 5A89TI 161012 TYPE = 

F3 017 5A89I 161013 TYPE = 

F3 017 5D52I LOCAL SNA MAJOR NODE 

F3 017 5C31I CA MAJOR NODE = N611 

F3 017 5D14I END 


* Display PATHTAB 
d net,pathtab 
=> 


F3 017 5A97I PATHTAB ACCEPTED 
F3 017 5D501 

F3 017 SF16I BDESTSUB ADJSUB 
F3 017 SFi7I 060 060 

F3 017 5SFi7I 061 061 

F3 017 5D14I END 

6.5 CIces/V¥S DEFINITIONS 


The steps to tailor the CICS/VS tables according to your needs are similar 
to those as mentioned in Chapter 5. 


VTAM DISPLAY - DOMAIN TYPE = 


» ACTIV 
» ACTS 


»CUA=012 
»CUA=013 


PATH TABLE CONTENTS 


ER ER STATUS VRCS) 


0 
0 


ACTIVS 
ACTIVS 


0 
0 


The table suffix may reflect your subarea number. 


The DFHTCTxx has to be expanded with terminals/terminal printers located 
Define these resources as 


in other domains. 
located in your subarea. 


For example, an IBM 3278 on an IBM 3274 local SNA control unit in subarea 
11 is defined as attached to your IBM 4331. 


Chapter 6: Multi 


System Environment 


if they were physically 


Raleigh International Systems Center 


The CICS/VS start job is the same as described in Chapter 5. 


Use your selected naming conventions and proceed to Chapter 5, section: 
"CICS/VS Definitions’. 


6.6 TEST OF YOUR CUSTOMIZED CICS/VS DEFINITIONS 

First, test your host attached environment as described in Chapter 5 
before you start to work with the cross-domain terminals. 

Make sure that all ACF/VTAM majornodes which reflect the cross-domain 
environment in the concerned subareas are ACTIV. Test each link separate- 


ly, subarea after subarea. 


When this has been done, run through the test procedure again from the 
other domain. Make sure that you use a terminal which is defined to CICS. 
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7.0 SWITCHED LINES 


This chapter is intended to assist the user in defining and using switched 
lines. 


Tt contains information about: 

e ACF/VTAM definitions for a switched rie 

° ACF/VTAM definitions for a switched major node 

e the remote hardware setup 

° determination of terminal identification 

° the operation of a switched line 

° session establishment on a switched line 

One or more lines on a Communications Adapter can be defined as switched. 


This is done by selecting opticns on the CA configuration table and pro- 
viding definitions to ACF/VTAM to support switched lines. 


7.1 CA CONFIGURATION 


To define a switched line on the CA configuration table, refer to Chapter 
3, section 'Permanent Changes!’ for details. Select 'YES' for the "SWITCHED 
NETWORK’ option and 'NO* for "PERM REQUEST TO SEND". You must not have 
permanent request-to-send CRTS) as switched lines are two-wire and con- 
trolled carrier 1s necessary for communication. The other options depend 
mainly on the modems you are using. 


7.2 THE ACF/VTAM DEFINITIONS 


The ACF/VTAM definitions for switched lines are provided differently to 
those for leased Cnon-switched) lines. The LINE definition is included 
under a GROUP statement with the parameter 'DIAL=YES'; all lines grouped 
by this GROUP statement must be switched lines. | 


Following each LINE macro is an entry for each PU that is able to make a 
dialled connection on the line. The PUs listed under the LINE macro are 
defined in a separate switched major node, with their associated LUs. The 
switched major node is created with a 'VBUILD TYPE=SWNET' statament at the 
beginning. 
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PUS on a switched line cannot be multidropped: only one at a time can be 


dialled on the line. 
Dial-In Definitions 
An example of a dial-in switched line definition follows: 


N0631 VBUILD TYPE=CA 


G603 GROUP LNCTL=SDLC, 
DIAL=YES 

L60033 LINE ADDRESS=033, 
CALL=IN, 
RETRIES=7, 
MAXBFRU=(€1,2), 
REPLYTO=5 

P60033A PU 

P60033B PU 


This defines a switched line which allows two PUs to dial in on that line 
CCALL=IN). 


The PUs listed under the LINE macro (P60033A and B in the example above) 
are defined in a switched major node, along with the associated LUs for 
each PU. | 


A unique identifier is provided in the PU definition through the IDNUM 
parameter; the device type is given in the IDBLK parameter on the PU macro 
(for more information see the section 'Datermining Terminal Identifica~ 
tion’ in this chapter.) 


An example of definitions for a dial-in switched major node follows: 


96031 VBUILD TYPE=SWNET 
P60033A PU ADDR=Cl1, 
PUTYPE=2, 
IDBLK=018, 
IDNUM=0DC4A, 
MAXDATA=262, 
USSTAB=USSSNA61, 
SSCPFM=USSSCS 
L60033A1 LU LOCADDR=2 
L60033A2 LU LOCADDR=3 
L60033A3 LU _LOCADDR=4 
P60033B PU ADDR=C1, 
| PUTYPE=2, 
IDBLK=017, 
IDNUM=00001, 
MAXDATA=262; 
USSTAB=USSSNA61, 
SSCPFM=USSSCS 
L60033B1 LU LOCADDR=2 
L60033B2 LU LOCADDR=2 
L6003383 LU LOCADDR=2 
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The first PU, P60033A, is a definition for a switched 3276 with three 
screens; the second is for a 3274. 


Dial-Out Definitions 


Alternatively, a node may be defined as as dial-out C(CALL=OUT) or both 
dial-in and dial-out (CALL=INOUT). The dial-out operation can be accom- 
plished manually or automatically. 


For dial-out operation, a PATH macro immediately follows the macro defin- 
ing each PU that can be dialled, which contains the dialling number for 
the PU CDIALNO). An example of the PATH macro follows: 


P60034C PU ...... 
VS601 PATH DIALNO=5435970,GRPNM=G6034% 
L60034C1 LU beak 

LU) ee Bae 


There may be multiple PATH statements for a PU, up to 256. 


The PATH macro can contain other information, such as the line group name 


associated with the macro. See ACF/VTAM Planning and Installation Refer- 
ence for details on the coding of this macro. 


Automatic Dial-Out 


An ‘autocall unit! can be used to automatically dial a peripheral node 
from the host. Where this is used, an AUTO parameter must appear on the 
line macro which has the unit, which specifies the address of the unit; up 
to two units can be used on the Communications Adapter. When an applica- 
tion program requests a session with the PU, ACF/VTAM uses the dialling 
information contained in the PATH statement to cause the autocall unit to 
dial the required number. 


Manual Dial-Out 


If CALL=OUT or CALL=INOUT is specified but no AUTO parameter is provided, 
manual dial-out operation will take place. When an application program 
requests a session with the PU, ACF/VTAM sends the information contained 
in the PATH statement to the ACF/VTAM operator, requesting that the number 
be manually dialled. 


7.3 DETERMINING THE TERMINAL IDENTIFICATION 


The way this is done depends on the hardware being used. Some devices, 
such as a 3276 and an 8775 have this unique identification hard-coded at 
time of manufacture, while others, such as 3274s, have the identification 
provided by the user. The identification is provided to ACF/VTAM on the 
"IDNUM=" parameter on the PU macro. The device type is provided on the 
*IDBLK=" parameter, and this is unique to the device type being used. 
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Information on terminal identification can be found in the Programmer's 
Guide for the device concerned. 


327% 
The IDBLK is fixed as 017. 


The IDNUM is set in the customization process by replying to question 215 
CPUID) with five digits. This could be derived, for example, from the 
serial number of the 3274. During customization, make sure that you speci- 
fy "1" to question 314 (Cpoint-to-point) and '0' to question 342 
Crequest-to-send). 


3el6 
The IDBLK is fixed as 018. 


The IDNUM is determined by the serial number of the device. The actual 
method for deriving the IDNUM depends on which of three ranges the serial 
number falls into. The three methods for calculating it can be found in 


the 3276 Control Unit Display Station Description and Programmer's Guide 
on page 4-45. The 'Terminal ID’ corresponds to the IDNUM. 


8775 
The IDBLK 1s fixed as 019. 


The IDNUM is fixed at time of manufacture. It can be found in the first 
five hex digits of the terminal setup label which should be attached at 
the rear of the terminal. It can also be obtained by going into terminal 
setup mode (see the 8775 Terminal User's Guide) and checking the terminal 
setup line. Example: 


<>OL5EXES83XOFCOX8000X1020*0000k0000*0005% 


The IDNUM for this 8775 terminal is O1L5EE : the first five digits, disre- 
garding the <> and the * . 


This number can also be determined by converting the last five digits of 
the 8775 serial number to hex. 


Alternative Method of Finding IDNUM 

An alternative way of finding the terminal ID is to define a switched line 
with PUs and a dummy entry Ce.g. use IDNUM=99999) for the device in ques~- 
tion. Dial-up the device to the host. When ACF/VTAM cannot find a PU 
defined with the ID of the device, it will generate an error message, 
e.g.: 


5G690I CONNECTION REQUEST DENIED ~- INVALID STATION ID = 02000180DC4A 


The last five digits of the message give the terminal ID that the device 
has responded with, in this case '0DC4A'. This should be used in the IDNUM 
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parameter on the PU macro. The three digits before that give the termi- 
nalts IDBLK. Here, it is '018' - a 3276. 


7.% OPERATION OF A SWITCHED LINE 


For dial operations to take place, the relevant line €s) and switched major 
node(s) must be active. This can be accomplished by the ACF/VTAM operator 
entering a VARY ACTIVE command for the line and node concerned, or by pro- 
viding an ISTATUS=ACTIVE parameter (this is the default) on the LINE macro 
and including the switched major node name in the configuration list. The 
lines’ and PUs' status should display as ACTIV and the LUs' status as 
CONCT before the dial operation takes place. 


For a dial-in operation with IBM 3864-2 modems, the remote modems at both 
ends should be in ‘data’ mode and the PU should be powered on Cand IMLed, 
if necessary). The remote terminal operator dials the host, and when the 
answer tone is heard, hangs up. A session 1s then established by ACF/VTAM 
and the PU. 


If for some reason the peripheral PU does not respond in time, the CA line 
will time out and generate a message similar to the following: 


5E46I 170 ERROR 033, TIMEOUT 227,0E00,402E 


If this happens you may need to vary the line inactive and re-activate it 
to make the dialled connection. 


For a manual dial-out connection, dial is performed as for a dial-in but 
the dial is made from the host end. 


For an automatic dial-out connection, the dial-out is performed automat- 
ically by ACF/VTAM and the autocall unit and operator intervention is not 
required. 


7.5 SWITCHED SESSTON ESTABLISHMENT 


When a dial operation has taken place, an XID Cexchange ID) command is 
first sent to the PU attempting the connection. The PU responds with 
information identifying itself to ACF/VTAM. This information is used by 
ACF/VTAM to determine which PU is making the call. If ACF/VTAM has been 
provided with the correct definitions for the PU, activation of the PU and 
its associated LUs can then take place. 


When the last LU-LU session terminates, that is, when the last terminal on 
the centroller logs off the application, the dial connection may be 
dropped Ci.e. the telephone is hung up) or the dial connection may remain. 
This is determined by coding the DISCNT parameter in the PU macro — for 


details see ACF/VTAM Planning and Installation Reference. 
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7.6 SWITCHED NETWORK BACK-UP (SNBU) FACILITY ON MODEMS 


The switched network back-up facility provided on modems such as the IBM 
3864 and 3865 allows a switched line to be directly substituted for a 
leased line in the event of failure of the leased line. 


With SNBU it is not necessary to have the facilities in the DTE equipment, 
that is, the host or the peripheral node, to be able to use a switched 
line. So, although ACF/VTAM does not support a switched line for an CA to 
CA link, it is still possible to use a switched line for backup of the 
leased line or even as a regular connection. 


The SNBU facility can, of course, be used also for peripheral nodes. 


Consider the example shown in Figure 22: 


4 medem line outage -—q modem 4 
3] C¢ | v C 3 
3| A. 3864-1 . 47 3864-1 A 3 
1 Leased Line. 1 

transmit receive transmit receive 
telephone A telephone C 


telephone B telephone D 


Figure 22. Using SNBU Modems for Leased Line Backup 


In this example, two IBM 4331s are connected via a 4-wire leased line 
using IBM 3864-1 modems with the SNBU feature. Attached to each modem are 
two switching telephones, one for the receive function Ctelephones A and 
D) and one for the transmit function Ctelephones B and ©). ACF/VTAM is 
running at both sites. 


In the event of a line failure, the operator at one of the sites can dial 
the other site and establish a switched connection. 


Here is an example of the series of events: 

1. When the leased line fails, ACF/VTAM will generate error messages on 
the system consoles notifying the operators of the failure. The lines 
Will remain ACTIV, as Data Set Ready is still present at each line, 
and at both sites the link station PUs will go into pending contacted 


status. 


2. The operator at one of the sites sets the modem to ‘talk’. 
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3. She then picks up the handset of the ‘receive’ phone (A) and dials the 
‘transmit’ phone at the other site (C), after lifting the exclusion 
button. 


4. When the tone is emitted, she does not hang up the phone. Next, she 
lifts the handset of the ttransmit* phone (3B), lifts the exclusion 
button and dials the ‘receive’ phone (D) at the other site. The actu- 
al order of dialling the phones (C'receive' or ‘transmit') does not 
matter. 


5. When the tone is received for the second dialling, she switches the 
modem to ‘'data’® and hangs both phones up. 


6. The modems establish a connection and synchronize. The interface pro- 
vided to each end is as for a leased line. 


7. ACF/VTAM. then performs recovery automatically and sessions are 
re-established. Messages are generated by ACF/VTAM and displayed on 


the consoles, informing the operators of the successful recovery. 


Note that the telephones only need to be supplied at the site making the 
calls; in the example the connections may be initiated from either end. 


The definitions at either end need not to be altered from those of the 
e normal, leased line. The CA configuration is not altered to 'switched’. 


In case of a peripheral link, the control unit need not to be set to 
switched mode. 


From both sites the SNBU dialled lines appear as a four-wire leased line. 


Notes 


1. This SNBU facility can, of course, be used not only for backup 
purposes, but for regular connections, thus providing a cost-efficient 
solution for a connection of two IBM 4331s, if a leased line is not needed 
permanently and therefore is too expensive to be considered. 


2. The modem SNBU feature is distinct from a switched line back-up, where _ 
both ends CCA and control unit) will operate in switched mode. 
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8.0 PERFORMANCE AND STORAGE REQUIREMENTS 


This chapter investigates some of the facilities available to control the 
performance of ACF/VTAM and its network. The chapter looks at things such 
as ACF/VTAM buffer pools, CA parameters affecting performance, and esti- 
mation of storage sizes for ACF/VTAM. 


8.1 BUFFER POOLS 


ACF/VTAM buffer pools are mainly used to control the passing of data 
between ACF/VTAM and the nodes in the network, and for internal control 
blocks. Requirements for these pools vary considerably, such as at start~- 
up time, during peak traffic periods and at shutdown. In order to make 
most efficient use of the available space, ACF/VTAM uses a technique known 
as dynamic allocation for many of its buffers. This allows the buffers to 
be dynamically expanded whenever necessary to cater for existing require- 
ments. 


_ Through parameters in the ACF/VTAM start list, the basic allocation and 
dynamic allocation can be controlled to a considerable degree. IBM default 
values are supplied and these are used where values are not provided in 
the start list. The IBM supplied values are not necessarily the most effi- 
cient values for a particular system, so it 1s recommended that the tuning 
exercises in this chapter be carried out. 


The general format of the specification for a buffer pool is: 


pPoolname = Cbhaseno,bufsize,slowpt,xpanno,xpanpt) 


8.1.1 Basic Allocation 


The basic allocation is the amount of space reserved for the buffer pool 
when ACF/VTAM is started. The first 3 suboptions for each pool specify the 
initial basic allocation. 


° baseno indicates the initial number of buffers provided in the buffer 
pool. 


e bufsize indicates the size in bytes of each buffer in the pool. Only 
the bufsize for LFBUF can be changed. 


e SLONPt indicates the point at which the buffer pool is to enter slow- 


down processing. When the number of buffers remaining in pool reaches 
this point, the buffers are allocated only for priority requests. Non- 
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priority requests are queued, or rejected with a return code. Slow- 
down processing ends as soon as the number of available buffers 
becomes equal to or greater than slowpt and there are no queued 
requests for storage. | 3 


The two additional buffer pool suboptions are provided to allow ACF/VTAM 
temporary changes in allocation. 


e xpanno indicates the number of buffers to be added to the buffer pool 
whenever a dynamic expansion is needed. ACF/VTAM will allocate whole 
pages for dynamic expansion. 


° xpanpt indicates the point at which dynamic expansion of this buffer 
pool will occur. When this point is reached ACF/VTAM will expand the 
number of buffers in the pool by the number specified by xpanno. The 
buffer pool will be contracted as soon as the number of available buf- 
fers in the pool reaches an internally calculated value. 


Dynamic allocation of buffer pools is the default for ACF/VTAM. Unless 
overridden, a default expansion as later shown in this chapter will be 
used. Dynamic allocation allows the user to reduce the amount of storage 
that must be permanently allocated for ACF/VTAM buffer pools. It also ena-~ 
bles the user to provide for temporary peak demands or for unexpectedly 
high demands for buffers, a feature that is useful when initializing a 
system. Although it is possible to override the ability for buffers to 
dynamically expand, it is strongly recommended that this is not done. 


8.2 TUNING OF BUFFER ALLOCATIONS 


The best way to select values for buffers is to provide initial values 
which will enable you to get the system up and running, then collect sta- 
tistics on the use of those buffers and modify the start list where neces- 
sary. 


8.2.1 IBN Supplied Defaults 


Not providing any values for buffers in the ACF/VTAM start list results in 
the buffer specifications as in Figure 23 on page 123. 
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POOL BASENO | BUFSIZE>* SLOWPT| XPANNO| XPANPT 


VFBUF*4 = 10240 0 
VPBUF* 4 262144 0 
SFBUF 356 0 
LFBUF 288 2 
SPBUF 100 0 
LPBUF 1016 0 
WPBUF 144 0 


Figure 23. Default Buffer Values for ACF/VTAM V2CVSE) 


8.2.2 Choosing Initial Values 


If you need to provide one or more values for a buffer, it is not necessary 
to include all the values. For example, if you want to change the value of 
xpanno only of the SFBUF from the IBM default of 3 to 4, use the following: 
SFBUF=(€,,,4,) 


The IBM default values will remain for values that have not been provided 
to give the equivalent of: 


SFBUF=(10,356,1,4,1) 


VPBUF 


When initializing ACF/VTAM for the first time, specify VPBUF=1048576. 
This value is large enough to start ACF/VTAM and to use the buffer trace 
facilities. 


If the value for VPBUF is not large enough and an activation of a node is 
in progress, the following error message will be issued by ACF/VTAM: 


5D80I ERROR FOR ID = NNNNNN-) —- REQUEST: ACTLINK , SENSE: 08120000 


33) When using D NET,BFRUSE the resulting display will show some buffers 
as being larger than defined: ACF/VTAM adds internal fields to the 
defined size. 

34 Important. | 7 | 
These buffers are not dynamically expandable, so it is important to 
provide sufficient storage for these buffers to cater for all circum- 
stances. 
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The meaning of the sense code as explained in the ACF/VTAM ‘Messages and 
Codes' is: 'tInsufficient resources. The receiver cannot act upon a request 
because of a temporary lack of resources.' | 


VPBUF is used to obtain storage for expansion requests on behalf of buffer 
pools that use virtual storage. : 


VFBUF © 


It is recommended that the initial start value for VFBUF be overridden as 
follows: 


VFBUF=20480 
as the default is not sufficient in some cases. 


VFBUF is used to obtain storage for expansion requests on behalf of buffer 
pools that use real storage. 


LFBUF 


BUFSIZE is not specifiable on the buffers except for LFBUF. However, if a 
channel-attached NCP is not being used, it is recommended that this BUF- 
SIZE be allowed to default to its value of 288. This value is calculated 
for an optimization of internal buffering based on the DOS/VSE 2K byte 
pagesize. | 


Most of the default values, an exception being VFBUF, should be large 
enough to meet the network configuration requirements and workload of many 
users. 


The initial values provided here should be sufficient to get the VTAM sys- 
tem running. : 


The next step is to use the ACF/VTAM display "D NET,BFRUSE’ and the 
ACF/VTAM BUFFER (SMS) trace to calculate more efficient values. 


8.2.3 DISPLAY NET,BFRUSE 


The *DISPLAY NET,BFRUSE' command should be used to tell whether temporary 
performance problems are a result of existing buffer pool values. This 
command can be used to find out which buffer pool is exhausted when 
ACF/VTAM error messages point to those problems. 


You can investigate the ACF/VTAM buffer requirements by keying in the com- 
mand at regular intervals, or by using the NCCF "EVERY'’ command which can 
automatically execute the command at regular intervals. Example: 


EVERY 15 D NET,BFRUSE 


This will cause the command to be executed every 15 minutes. 
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The most efficient way for the system to run is if dynamic expansion is 
not invoked until a peak is encountered. To achieve this, reduce the ini- 
tial allocation (Cbaseno) values until the D NET,BFRUSE command shows that 
dynamic allocation is starting to take place under normal, non-peak condi- 
tions. Now, use a value slightly larger than this for your initial allo- 
cation value and allow dynamic expansion to take care of the peak periods. 
Remember that a large basic allocation is more processing efficient, but 
more storage is tied up for the pool and this may be the limiting factor in 
your system. 


Figure 24 shows an example of the output of the DISPLAY NET,BFRUSE 
command. 


HE HE HE HEHE HE HK EE HK DE DE DE HEH DE IE DE HE HE HK HE HE HE DE HE HE DE HE HE HE HK HE HE HE HK DE DE HEE DK DE HE 3 HK DK DED HK DE HEHE DHE DE HE DE EK EK EK EH 
os DISPLAY NET,BFRUSE % 
HE HH HEH HEHE HE HE HE HED HE HK DHE HE DK HE HK HEHE HK HE HE DHE OK HEHE DK HE HEHEHE HK HE HE DK DHE HH HEH HE HK DE HE HE HHH HK HHH IE HEH HEN 
=>D NET,BFRUSE 

DA9TI DISPLAY ACCEPTED | 

5D50I VTAM DISPLAY - DOMAIN TYPE= BUFFER POOL DATA 

5G32I BUFF BUFF CURR CURR MAX MAX TIMES EXP/CONT EXP 
5G33I ID SIZE TOTAL AVAIL TOTAL USED EXP THRESHOLD INCR 


5D56I VF 02048 00010P O0003P N/A O0007P NZA N7A N/A 

5D56I VP 02048 00128P 00071P N/A O00063P N/A N/A NZA 

5D561I SF 00356 00015 00008 00015 00009 900001 00003/00013 00005 
5D561I LF 00343 00017 00014 00057 00049 060008 00003/----- 00005 
5D56I SP 00112 00036 00036 00036 00000 00000 00003/----- 00017 
5D56I LP 01016 00016 00012 00016 00008 9690000 00001/----- 00002 
5D56I WP 00160 00024 00017 00024 00010 00000 00003/----- 00012 


5F95I IRNLIMIT = NOLIMIT, CURRENT = 000000K, MAXIMUM = 000000K 
5D14I END 


Figure 24. ACF/VTAM BFRUSE Display 
° BUFF ID 
The buffer pool ID 
° Flags 
Q = queued request for this pool 


dynamic buffering failed for this pool 


F 
° BUFF SIZE 

The size of each buffer in this pool. Note that some buffers do not 

display as they are defined in the start list, as ACF/VTAM will add 

internal control blocks to the buffer size. 


° CURR TOTAL 


The current total number of buffers in this pool. The 'P* indicates 
that the storage is measured in pages 
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-® CURR AVAIL 


The current count of buffers that are available. The ore indicates 
that the storage is measured in pages | | 


e MAX TOTAL | 


The largest number of buffers that this pool has expanded to at any 
time | 


° MAX USED 
The largest number of buffers in use at any time 
e TIMES EXP 
Cumulative count of the number of times each buffer pool has expanded 
e EXP/CONT THRESHOLD 
Expansion and contraction thresholds 
e EXP INCR 


The expansion increment which gives the number of buffers to be added 
to a buffer pool during dynamic expansion 


° IRNLIMIT 


This dascribes the pageable storage use for Intermediate Routing Node 
traffic that cannot be routed to adjacent subarea nodes because those 
subarea are in slowdown mode. : 


For tuning purposes the values of "MAX USED’, "TIMES EXP", and "EXP/CONT 
THRESHOLD’ are very important. If the value of "MAX USED’ matches the val- 
ue of "MAX TOTAL’ or comes close to it, the 'TIMES EXP" value should be 
analyzed. If there is a high value, that means that there has been a lot of 
expansions, the BASENO of this buffer pool should be increased. 


8.2.% ACF/VTAM Buffer (SMS) Trace 


Statistics may be collected on the use of ACF/VTAM buffers by running the 
SMS trace. These statistics, with the exception of the wait value, con- 
tains the same values as results from the D NET,BFRUSE command. There are 
a couple of differences: firstly, the collection is not timer initiated 
but occurs after 1000 requests to the buffer pools; secondly the counters 
are raset at each collection. Tha trigger of 1000 requests can be changed 
to another value, but this is not normally necessary. For details on how 
to do this, see ACF/VTAM V2 Diagnosis Guide. | 
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An example of initiating the ACF/VTAM buffer usage trace in combination 
with the trace facility of SDAID is shown in the chapter 'Problem Determi- 
nation’ under the section SDAID. The. statistics are written to tape; this 
can then be printed with DOSVSDMP as shown tn the same chapter under 
"DOSVSDMP'- again, an example is given. 


The details are explained as follows: 
@ IN USE 


Indicates the number of buffers that were in use at the time the snap- 
shot dump was taken. For the variable pageable pool (VP) and the vari- 
able fixed pool CVF), INUSE indicates the number of pages that were in 
use at the time the snapshot dump was taken. 


° MAX ALLOC 
Indicates the maximum number of buffers in the pool that were in use 
at any one time during the time covered by the snapshot dump. For CVP) 
and (VF) MAX ALLOC indicates the maximum number of pages that were in 
use at any one time during the time covered by the snapshot dump. 

° MAX WAIT 
Indicates the maximum number of requests for buffers that were queued 
waiting for storage at any one time during the time covered by the 
snapshot dump. This field has no meaning for VFBUF or VPBUF. 

° EXPAND 
Indicates the number of times the buffer pool was expanded during the 
time covered by the snapshot dump. This field has no meaning for VFBUF 
or VPBUF. 

e MAX AVAIL 
Indicates the maximum number of buffers that were in the pool at any 
time during the time covered by the snapshot dump. This field has no 
meaning for VFBUF or VPBUF. 

® CUR AVAIL 


Indicates the number of buffers that were in the pool at the time the 
snapshot dump was taken. This field has no meaning for VFBUF or VPBUF. 
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8.3 CA PARAMETERS AFFECTING PERFORMANCE — 


This section discusses definition parameters for devices on CA lines that 
can affect the performance of those devices. _ 

Figure 25 shows a CA configuration example, followed by the definitions 
for the SDLC and the BSC lines. 


IBM 3276 BSC 


IBM 3276 SDLC 


VTAM V2 


Figure 25. CA Configuration example 
Definition statements for an IBM 3275 on an SDLC link: 


REM1 VBUILD TYPE=CA 

GROUP 1 GROUP. LNCTL=SDLC, | ¥* 
DIAL=NO 

LINEQ31 LINE ADDRESS=031, X 
MAXBFRU=(1,2), * 
PAUSE=0.1, x 
REPLYTO=1, x 
RETRIES=7, x 
SERVLIM=4% 

PUOS3I PU ADDR=C1, * 
PUTYPE=2, % 
MAXDATA=262, x 
MAXOUT=7, x 
SSCPFM=USSSCS, % 

LOGAPPL=DBDCCICS 


D62R0311 LU -LOCADDR=2, x 
ISTATUS=ACTIVE 
D62R0312 LU — LOCADDRE=3, x 


ISTATUS=ACTIVE 
Definition statements for an IBM 3276 on an BSC link: 
REM2 VBUILD TYPE=CA 


GROUP1 GROUP LNCTL=BSC 
LINEQ3O LINE ADDRESS=030,SERVLIM=4 


CLO30 CLUSTER GPOLL=40, % 
CUTYPE=3271, x 
ISTATUS=INACTIVE, x 
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LOGAPPL=DBDCCICS 


D62R0301 TERMINAL ADDR=40, as 
TERM=3277, x 
FEATUR2=MODEL2, x 
ISTATUS=ACTIVE 

D62R0302 TERMINAL ADDR=C1, % 
TERM=3277, % 
FEATUR2=MODEL2, x 


ISTATUS=ACTIVE 
LINE-Related Parameters 
MNAXBFRU (SBDLC only) 


MAXBFRU specifies the number of buffers (LFBUF) to be used to read data 
from this line. 


Specify two values: 


© norm: This number indicates the number of LFBUFs ACF/VTAM will use 
whenever it reads data froma line. 


o max: This number indicates the maximum number of LFBUFs to be used to 
read data from this line. This must be enough to hold the largest PIU 
that can be received over this line. 


In the START option list the length of the LFBUF is specified Multiplying 
this length with the values of MAXBFRU gives the normal and the maximum 
I70 area length ACF/VTAM will allocate to read from this line. Specify a 


max value at least large enough to read the maximum PIU length from the 
line. 


The default values are: 
For PU type 1 or PU type 2 connected to the line: (1,2). 
For PU type 4 or PU type 5 connected to the line: (2,8). 


For BSC IBM 3270 this parameter is invalid as only one buffer is used of at 
least 256 bytes. 


PAUSE (SDLC only) 
The PAUSE operand specifies the time the communication adapter will wait 
after a normal data poll cycle of all PUs on this line, when all PUs on the 


line answer by negative response (no data to send). 


Polling on other lines may continue but this line will not be polled until 
the time specified by the PAUSE operand has elapsed. 


wasteful operations on the link and Communications Adapter usage overhead 
can be avoided by selecting an adequate value for this parameter. 
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The default value is 0.1 seconds, and this is considered reasonable for 
most interactive situations. Non-interactive devices can be defined with 
a higher value. | 
REPLYTO (SDLC only) 

This operand applies when ACF/VTAM is operating as primary side: i.e. in 
a configuration where a CA line connects two 4300s, it applies only to the 


ACF/VTAM in the higher subarea. 


Unless the CA receives a response to polling (frame with poll bit=0N) 
within the specified time the CA will judge it as an Idle Detect Timeout. 


The Idle Datect Timeout should take into account: 

© Propagation time to the secondary station. 

® Processing time at secondary station. 

® Clear to send delay at secondary station. 

® Propagation time from secondary station. 

At the datection of a Idle Detect Timeout ACF/VTAM will attempt to recover 
according to the RETRIES operand. It will make unlimited retrias for the 
SNRM command. The default is one second. 


RETRIES 


Specifies the number of retries ACF/VTAM Cas primary station) will 
perform. 


The specification should be large enough to permit the recovery of tempo- 
rary errors, but small enough to cut down the delay of notification of 
unrecoverable errors. 


This retry counter is applicable to the following errors: 


© Timeout (for SNRM the retry is repeated continuously regardless of 
this specification) 


e Negative acknowledgement 

® Data check Cexcluding I frame) 
® Invalid address 

® Buffer overflow 

e Overrun 


The default value is RETRIES=7. 
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SERVLIM (SDLC) 


This parameter specifies the number of normal data scans which the CA will 
repeat on the PUs of this line before it starts special service on PUs on 
this line. 


Normal service is the service for exchanging PIU's with a PU. PIUs can be 
I Cinformation) or S Csupervisory) SDLC frames. | 


Special service is used for sending non-sequenced SDLC frames Ce.g. SNRM) 
to Pus. 


Supposing one or more PUs on a multipoint line are powered off, then they 
need special service Ctransmission of SNRM) from time to time to detect 
when they power on. The CA will poll for normal service all other PUs on 
the line as many times as the value specified in the SERVLIM operand, then 
it will check if any PU requires special service, if yes it will execute 
the special service to one PU alone and then go back to normal service. 
EXAMPLE: 

A multi point line has 4 PUs A,B,C,D connected to it. 

® PU A and C are active requesting normal service 

® PU B and D are inactive requesting special service 


SERVLIM=2 


The sequence of service will be as in Figure 26 


A->C—> A—> C—> B—> A> C— > A— > C—O DO A-O Cm OA ee etc. 
special special 
service service 


Figure 26. Service Order Example 
The default is 4 seconds. 
SERVLIM (BSC) 


The SERVLIM parameter on the Line macro instruction is used differently by 
ACGF/VTAM for BSC support. 


ACF/VTAM uses this as the maximum number of output operations CWRITEs) 
performed per line before a polling operation is started. In this respect 
SERVLIM ona line basis acts somewhat similar to a SDLC PUs MAXOUT param- 


eter. 


The dafault is 4 seconds. 
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PU and LU-Related Parameters | 
MAXDATA 


This parameter specifies the maximum length of data the PU can accept in 
one data transfer: that is, the length of either an entire PIU or one PIU 
segment. This in turn depends upon the physical size of the buffer of the 
PU or cluster controller Ce.g. 3274), which can be found in the relevant 
component description guide. ; 


This maximum data length includes the transmission header (TH) and the 
request/response header (RH). The transmission header (TH) langth is 2 
bytes for a PU type 1 and 6 bytes for a PU type 2. For traffic between sub- 
areas (PU types 4 and 5 ) the TH may be 10 Cnon-SNA devices or nodes that 
do not support explicit and virtual route protocols e.g. ACF/VTAME ) or 26 
(where the nodes do support ER and VR protocols e.g. ACF/VTAM V2). 


The request/response header (RH) is always 3 bytes long. 
The RU contains the user data and varies in length. 


If TH+RH+RU is larger than MAXDATA then ACF/VTAM will automatically seg- 
mant it. 


MAXOUT 


This parameter specifies the maximum number of path information units 
(PIU) or path information segments ACF/VTAM can send to this PU without 
receiving a acknowledgement from the PU. 


ACF/VTAM will perform the following operations on SDLC links according to 
the value of MAXOUT: 


1. ACF/VTAM will send PIU or PIU segments as SDLC I frames to the PU 
until the MAXOUT value is reached. 


2. When MAXOUT is reached ACF/VTAM will poll the destination station CPU) 
to make sure that all I frames have been correctly received. 


55 The destination station will set a receive count in the response frame 
| to acknowledge correctly received frames. 


4. ACF/VTAM will examine the eueaive count in the response frame. If the 
receive count acknowledges all the I frames that have been sent then 
ACF/VTAM will repeat steps 1, 2 and 3 to send the next PIU or PIU seg- 
ments. | 


If a negative response is given to some or all of the I frames 


ACF/VTAM will resend the I frame containing the error and all subse- 
quent I frames. 
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5. When ACF/VTAM has completed the transmission of all the PIUs it will 
immediately poll the destination station (PU) to obtain confirmation 
aven although MAXOUT has not been reached. 


SDLC limits the value of MAXOUT to 7 or less. 


Generally a large value should be specified for applications that handle a 
large amount of outbound batch data, although such an application can mon- 
opolise the line. 


If the line has a low quality, a low value (such as 2) should be specified 
to avoid retransmission of many PIUs after a line error. 


On high quality lines specifying a high value (such as 7) will improve 
line utilization. 


Also check the characteristics of the PU for the MAXOUT value. 
The default value is MAXOUT=1. 
PASSLIM (multipoint lines only) 


PASSLIM specifies the maximum number of I frames CPIUs or PIU segments) 
which ACF/VTAM will send to a PU in one service. 


ACF/VTAM will move to the next PU on the line when as many I frames as the 
PASSLIM value have been send to one PU or when all I frames in the queue 
are completely sent. 


The service of a specific PU on a multi-point line can be improved by spe- 
cifying a high value as PASSLIM parameter for the PU. 


If the value of PASSLIM is too high for a specific PU, this PU will occupy 
the line exclusively for a long period of time and other PU will be wait- 
ing too long for service. Therefore this parameter must be handled with 
care when batch PUs and inquiry PUs are mixed on one multi-point line. 
Conclusion of some studies has indicated that PASSLIM should be 1, 2 or 3 
on multipoint lines; if full-duplex, no batch then use PASSLIM=1 and MAX- 
OUT=7. | 


The PASSLIM parameter is effective on outbound data only, it has no direct 
effect on inbound data. | 


Indirectly it will affect the time between polls. 


The default is the MAXOUT value. 
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Relationship Between PASSLIM and MAXOUT 


The way ACF/VTAM will operate depends ona sone ientias of PASSLIM snd — 
OUT and is i aUaeraeee by the following examples: 


1. PASSLIM < MAXOUT 


ACF/VTAM will send as many I frames as PASSLIM, then it will move to 
the next PU on the line. It will poll the first PU, requesting a 
response, when the number of I frames sent reaches MAXOUT during a 
subsequent service. | 


2. PASSLIM = MAXOUT 
ACF/VTAM will send as many SDLC I frames to the PU as specified in 
PASSLIM, poll the PU and receive the rasponse and will then move to 
the next PU on the line. 

3. PASSLIM > MAXOUT 


 ACF/VTAM will sand as many SDLC I frames to the PU as MAXOUT allows, 
poll the PU and receive the response. Then it will continue to send I 
frames to the same PU until PASSLIM its reached in which case it will 
move to the next PU on the line. 


It is recommended that MAXOUT=PASSLIM be specified. This will cause an 
acknowledgement after each service. 


The determination of the values for MAXOUT and PASSLIM depend heavily upon 
the type of application for each PU on the Link. 


Basically, the LUs connected to a PU can be divided into three different 
classes. 


Ll. Inquiry LU 


LU that receives one output message from the host for each input mes- 
sage - a typical interactive 3270 application. 


2. Inbound batch LU 


LU that sends mainly consecutive input records to the host, such as a 
data-entry application. 


3. Outbound batch LU 


LU that receives mainly consecutive output from the host, such as a 
remote printing facility. 


The following tables give a guideline for the specifications for PASSLIM 
and MAXOGUT for point-to-point and multi-point lines. 
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Applicatfron of PU MAXOUT PASSLIM 
PU with INQ. LU SMALL 


N.A 

only 35 
= - 
LARGE N.A 


PU with inbound 
batch only 


PU with outbound 
batch LU only 


PU with Indg.LU 
and Inbound batch LU 


SMALL 
SMALL 


Figure 27. MAXOUT and PASSLIM Values for a Point to Point Line 


pepe ce tten of PU per wrens PU MAXOUT PASSLIM | 
PU with ands LUs =a 


PU with Inbound 
IN BATCH 


PU with Inq.LU and 
outbound batch LU 


Batch LUs only 


PU with Outbound 
Batch LUs only 


PU with Inbound BATCH] 
LUs only plus PU with 
INbound batch LUs 


PU with Inq.Lus only 
‘plus PU with Inbound 
Batch only 


}PU with Inq. LUs only 
plus PU with Outbound 
Batch LUs only 


Figure 28. MAXOUT and PASSLIM Values for a Multipoint Lina 


35° PASSLIM is meaningless for point to point lines. 
36 MAXOUT is only applicable for outbound data. 
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&.4 STORAGE REQUIREMENTS 
The actual storage required to run ACF/VTAM depends upon several things, 


most of these dependent upon the size and activity of the network: 


® VPBUF storage 


© 


VFBUF storage 


ALLOC, ALLOCR and EXEC statements 
® zero paging storage 
e storage for activation of channel-attached devices 


Note: 
The EXEC statement should be coded as follows: 


// EXEC ISTINCVT,SIZE=1130K 


If SIZE=AUTO is specified, ACF/VTAM will try to load all of its control 
programs in storage and will not leave enough room for its other storage 
areas. Thus when ACF/VTAM is required to load any of its special handlers 
there won't enough space left to load them and ACF/VTAM may abort, depend- 
Ing on what was requested. 


The size of the ACF/VTAM partition can be defined by the ALLOC and ALLOCR 
commands as: 


1844K for the virtual storage CALLOC), and 
200K for the real storage CALLOCR). 


This is sufficient for a small to medium size network without an NCP, but 
for most efficient use of your system's storage, it is recommended that 
you use the tables in Appendix F-15 of ACF/VTAM V2 Planning and Installa- 
tion Reference to calculate ALLOC, ALLOCR and other storage. 
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9.0 PROBLEM DETERMINATION 


This chapter provides information for basic problem determination tech- 
niques, and briefly investigates some of the tools and products that are 
available for your use. In problem determination in an SNA environment, a 
good basic understanding of SNA fundamentals is necessary. This chapter is 
not intended to provide this, rather, to point the problem resolver in the 
right direction, to show some of the tools that are available for P.D. and 
to give some examples of typical problems that might be encountered. 

The chapter is divided into the following sections: 

® approaching a problem in an SNA environment 

e use of ACF/VTAM displays, status and sense codes, 3270 codes 

hardware tests 

e software checks 

e traces, ACF/VTAM and VSE 


¢ use of dumps and how to produce them 


° where to go to get more information 
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9.1 APPROACHING A PROBLEM 


SNA is a layered architecture and problem determination should be 
approached in a manner which takes advantage of this. For example, if a 
problem occurs which involves the application-to-terminal session CLU-LU 
session) it means that the other sessions have already been established 
successfully ~- i.e. SSCP-PU, SSCP-LU. This in turn means that the link 
hardware Cmodems,lines) and the control unit must be functioning correct- 
ly. Conversely, if there'is a problem in activating a line, we know that 
the application program is not the cause. 


9.1.1] ACF/VTAM Displays 


The first step, then, in determining the cause of a problem should be to 
identify the layer that the problem is in. 


ACF/VTAM displays are always a good starting point. They can display such 
things as PUs, LUs, lines, major nodes, application programs, cross 
domain resources, and many others. The ACF/VTAM display of a node gives 
general information about it and if requested, information about other 
nodes associated with it. One technique is to display the ACF/VTAM compo- 
nents down through the levels to find the first level at which the problem 
appears. The general format for this command is: 


D NET, ID=nodename<, E> 

. where nodename is the ACF/VTAM name of the node. The ',E* appended to 
the end of the command requests the display of all its subordinate 
resources. 
The display: 
D NET,PENDING 

is also useful for quickly identifying problems. This shows which nodes 


are in a PENDING state, that is», ina transient state to or from the fully 
active state, or with a BIND or UNBIND outstanding. 


9.1.2 ACF/VTAM Status Codes 


An ACF/VTAM display shows two status codes - the current state and the 
desired state. The desired state is the condition that ACF/VTAM is trying 
to establish. This can be as a result of operator commands or ACF/VTAM 
recovery procedures (or ACF/VTAM POI programming’? ). When the 


138 


Raleigh International Systems Center 


command/procedure has completed successfully, the two states will be the 
same. | 


A comprehensive list of status codes and their meanings can be found in 


ACE/VTAM V2 Messages and Codes, appendix E, the Diagnosis Guide, appendix 
B or the Reference Summary. 


9.1 SNA Sense Codes 


A sense code is sometimes generated by ACF/VTAM when a component fails or 
a command cannot be completed, and this may appear on the screen or ina 
trace. This 4-byte field provides information on why a request was 
rejected. The format is shown in figure 1. 


byte 0 1 2 3 


Category Modifier Sense Code Specific 


Info. or User Data 


[<-eeS= Sense Code ------ > | 
[SSS S>> EXGGpt ion Code sees eH SSeSseessessseessee= > | 


Figure 29. Structure of Sense Code Information 


A complete description of SNA sense codes and their meanings can be found 
in ACF/VTAM V2 Messages and Codes, appendix G. 


9.1.4 3270 Displays 


Displays attached to 3274/6 warrant a special mention as the intelligent 
controllers are able to detect, log and display errors in communication 
hardware, programs and protocols. These are shown with symbols and numbers 
under the operator line of a screen attached to the controller. The mean- 
ings of the numbers) generated can be found in the 32746 Control Unit 


Description and Programmer's Guide, or the IBM 3270 System Problem Deter- 
mination Guide for the 3274 or 3276. 


37° POI is the Programmed Operator Interface, which allows an authorized 
ACF/VTAM application program to issue ACF/VTAM commands. A guide to 
this can be found in ACF/VTAM V2 Programming. 
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Generally speaking, with a 3274 the error codes are as follows: 
2nn _ hardware problem 
nn = program/protocol error 
5nn ~ communications error 
Common errors for a 3274 controller are: 
4017402 3274 addressing problem. 
Check MODEL number. 
407 As for 40172, or screen does not 
have extended attributes. 


450-456 Bind reject. Check ACF/VTAM definitions, 
LOGMODE entry, or CICS TCTs. 


201 Secondary modem problem. 
510 PU needs activating. 
521 Problem on line, or host down. 


Codes are generated for 3276s in a similar fashion but are different to 
those generated by a 3274. Each code generated is accompanied by an error 
symbol indicating the classification of the error code Ci.e@. program, 
communication, hardware) for the benefit of the operator. 


9.1.5 8775 Display Terminal 


8775 displays are also able to diagnose errors and record them, ina simi-~ 
lar manner to the 3270's. The error log displays on the 8775 are mainly 
for the use of IBM service personnel. To display them: 


1. put the terminal in TEST mode by holding down the ALT key and pressing | 
the TEST key. 


2. key a 9and press enter. 
Any failures that have occurred on the terminal since the last error log 


reset will be displayed. To reset the log, enter an A instead of 9 and 
press enter. | | 
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9.2 HARDWARE TESTS 


9.2.1 Loop Adapter Attached Devices 
Various tests and displays can be made of loop adapter attached devices 
from the console of the 4331. To execute these: 


e Invoke the LA INLINE TEST screen by pressing MODE SEL and selecting 
the option: 


F LOOP ADAPTER 


The next screen that is shown is the LOOP ADAPTER CONFIGURATOR screen. 
Select: 


C INLINE TESTS. 

e Press PF1l to commence execution of the tests. This will place the 
screen back in program mode. To control the test from the console, 
press the CHG DPLY key. 

e Commands can now be entered from the console such as: 

a 001 to display loop messages 

— 007 to assign a device and 550 to test it 
= 010 to display statistical counters 

= A00-A04 to execute loop wrap tests 

—- 000 to end tests 

Full details of these tests and displays can be found in the IBM 4331 Loop 

Adapter Operating Procedures. This manual should be used in conjunction 

With the IBM 4331 Loop Adapter Problem Determination Guide to isolate 

hardware problems on the loop. The console operator can display the 


group/device counters daily to help predict certain hardware problems. 
Hard copies may be made of the displays. 


9.2.2 3270 Devices 


There are various tests and error log checking procedures that can be run 
on a 3270 display, if it is suspected of causing an error. TEST mode is 
entered by holding down the ALT key on a 3178 or 3278/93 and pressing the 
TEST key. You can then use the test/error log display facilities. Qne of 
these is the Status Summary Display. This can be used to check a problem 
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display or screen, or could be used in daily operation to check for poten- 
tial problems. To invoke it, enter 73: from TEST mode on any screen and a 
display similar to Figure 30 on page 142 will be shown. 


012345678901234567890123 45678901 
000111010111101100100111 061000-01 
dddddd_podddd_idd_odidpdd dddddddd 


oee ef © @ @ @ 
e 


0000 0000 0013 0013 0013 


Figure 30. 3274 TEST 73 Display 


The example provided shows the display from a screen attached to a 3274; a 
3276 shows a similar display but some of the lines are not present. The 
actual content of the display is dependent upon the E.C. or microcode lev- 
el of the controller. 


Line 1 indicates the port of the terminal. Blanks separate type A and type 
B terminals (24 type A and 8 type B shown here). 


Line 2 shows whether the terminal is powered ON (1), OFF (€0) or has been 
disabled by the control unit due to errors (~). 


Line 3 indicates the device type - display (d) printer Cp) or that the 
port has not had a powered-on device attached to it since the control unit 
was IML'd (-). 


Lines 4 and 5 show the number of coax and device errors logged for that 
terminal as follows: 


no errors 

1 to 9 errors 

19 to 19 errors 
20 or more errors 


° 
e 


¥ 


ior 6G oa 


Line 6 shows a (+) if there is a session bound. 
The bottom line is formatted as follows: 


MMMM CCCC PPPP RRRR XXXX 


MMMM = summary count of control unit machine checks 
cccc = summary count of communications checks 
PPPP = summary count of. program checks 

= summary count of SDLC Test commands received 


RRRR 
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XXXX = summary count of SDLC Test commands 
successfully transmitted 
Other tests can be found in the problem determination guide which is 
attached to the keyboard of any 3278/73. The tests include sequences which 
can check out the screen and the controller adapter and identify the fea- 
tures attached to the screen (such as Programmed Symbols, Extended Attri- 
butes). In addition, the guide provides explanations of the operator 


symbols generated. For more detailed information, refer to the IBM 3274 
Control Unit Dascription and Programmer's Guide. 


Several other tests/error log displays are available mainly for use by the 
IBM Customer Engineer. 


9.2.3 8775 Display Terminal 


The 8775 has the ability to run diagnostic tests on itself. The tests 
are: 


° Test 0 - Basic Assurance Tests 

e Test 1 - Terminal Read/Write Storage Test 

¢* Test 2 - Highlighting and APL Test 

° Test 3 ~- Programmed Symbols Test 

® Test 4 - CRT Alignment Pattern 

° Test 5 - (mod 11 and 12) Data-Link-Adapter Wrap Test 

® Test 6 - Cmod 1 and 2) Loop-Station-Adapter Wrap Test 

® Test 6 ~ (mod 11 and 12) Data-Link Basic Assurance Test 
° Teast 7 - Selector Light Pen Test 

e Test 8 ~ Magnetic Stripe Reader Test 

® Test 9 ~- Error Log Display 

e Test A - Error Log Reset 

@ Test B - (mod 11 and 12, Japan only) Communication Line Driver Test 


Full details on the running of these tests can be found in the manual IBM. 


8775 Display Terminal Terminal User's Guide under the section 'Problem = | 


Determination Test Procedures’. 
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9.3 LINK LEVEL 2 TEST 


This is a test which can be run to datermine problems on a non-switched 
SDLC link. This can be a CA to peripheral PU link, a CA to CA link or a CA 
to NCP link. 3 = : 


To run the test to a peripheral station, the link must be active and the PU 
at the secondary end, inactive. 


With the CA to CA link, the test must be conducted from the primary end, 
the one with the higher subarea address. The test will fail if run from 
the secondary end. 


Between a CA and an NCP, the host controlling the NCP must initiate the 
test as the NCP is always considered the primary node. 


In both the CA-CA and the CA-NCP case, the link must be active, the prima- 
ry end must see the secondary as inactive or inoperative and the secondary 
must see the primary as pending contacted. This can be set up in one of two 
ways: | 


° If both the primary and the secondary ends are inactive, vary the pri- 
mary-end PU active from the secondary end with the ACF/VTAM command: 


VARY NET, ACT, ID=linkstati onname*® 


° If both ends are active, vary the secondary end inactive from the pri- 
mary end with the ACF/VTAM command: 


VARY NET,INACT,ID=linkstationname?®® 


The test can now be initiated; the following ACF/VTAM command is entered 
from the console: 


F NET,LL2,ID=name 
<,DATA=data> 
<,NFRAMES=n> 
<,NTRANS=m> 
<,OPT=CANCEL | CONT> 


DATA Coptional) is user data 


NFRAMES Coptional, default=1) its the number of test messages to be sent to 
the PU each time its station is selected (multipoint line) 


38 linkstationname is the PU name of a peripheral PU or a link-station 

| name. If a CA-CA or CA-NCP link is being tested, the link-station is a 
representation of the PU at the remote end of the link. Its name can 
be determined by using the 'D NET,ID=line,E* command and looking at 
the field LNKSTA. The command 'D NET,STATIONS' also displays all link 
stations. 
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NTRANS Coptional, default=10) is the number of test messages to be sent 


OPT=CANCEL (Coptional) cancels the current test while OPT=CONT runs the 
test continuously. 


The test data is sent to the link station and returned. ACF/VTAM then dis- 
plays information regarding the data sent and the data returned. This 
indicates: 

° the number of test messages sent 


e the total number of test messages returned 


e the number of test messages returned without error 
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9.4% LU CONNECTION TEST 


This test can be initiated on the SSCP-LU session by a terminal operator 
.to quickly check that communication with the host is possible. Using the 
IBMTEST command enables the user to find out if all his initial defi- 
nitions are working correctly or not, independent of his application pro- 
gram. 


The command IBMTEST causes test data to be returned a specified number of 
times to the terminal. The terminal user may specify the test data charac~y 
‘ters, or if no data is given, a predefined sequence will be supplied by 
ACF/VTAM, 


SSCP-LU Session for a non-SNA Terminal 


The terminal is in the SSCP-LU session when it has been activated and USS 
MSG10 - the logon message - has appeared. If the terminal is automatically 
logged on to CICS at this point Cas a result of the LOGAPPL parameter) 
then you will need to use a CICS command from the CICS master terminal to 
release it first: CSMT TERMNL,SIN,REL, TERMID=xxxx 

.. Where xxxx 1s the CICS terminal name. 


Then, instead of entering a logon command, follow the instructions "Run- 
ning the IBMTEST' below. 


On a 3178 or 3278/79 look for a human stick-figure in a box under the opera- 
‘tor line to the left of the screen. If it is not there, hold down the ALT 
key and press the SYS REQ kay. It should now appear. 


RUNNing the IBMNTEST 
The following command executes the test: 
IBMTEST <n]10><,userdata> 


nj[10 ==> Number of times the test data should be returned. The maximum 
value of n is 255. The default value is 10. 


userdata ==> Test data to be sent back to the terminal. The default data 
are the characters A-Z and 0-9. 


Note: 

During the execution of the IBMTEST, i.e. until the requested test message 
has been sent ‘n' times, no data entry is possible from the terminal being 
tested. 


If an error occurs during IBMTEST ACF/VTAM will issue an error message on 


the operator console. The following error message is an example of an I/0 
error during the test phase: 
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5E73I CONNECTIVITY TEST TO NNNNNNNN TERMINATED AFTER X ECHOES DUE TO I/0 
ERROR, SENSE: 08060000 


If the test completes without error, the message 'IBMTEST' followed by the 
data will remain on the screen and no error message will be generated. 
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ACFE/VTAM TRACES 


If a problem cannot be resolved by investigating ACF/VTAM displays and 
messages, you may need to trace the data flowing between the various com- 
ponents. ACF/VTAM provides several trace facilities for use in the CA 
environment: 
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Buffer Contents Trace. | 

It is recommended that you use this option for tracing activity on 
PUs, LUs, the SSCP, cross domain resources etc. as it provides up to 
256 bytes cf the PIU. Use this option to inspect a BIND which is caus-~- 
ing problems, or when the user data needs to be inspected. 


To start the trace: F NET,TRACE, TYPE=BUF,ID=nodename 

To stop the trace: F NET,NOTRACE, TYPE=BUF, ID=nodename 

I/70 Trace. 

This is useful for investigating activity between ACF/VTAM and net- 
work nodes, similarly to the Buffer Contents Trace. However, it only 
records the first 36 bytes so little user data is displayed. This 
saves trace file space, and it is useful where user data need not be 
inspected. | 

To start the trace: F NET, TRACE, TYPE=I0,ID=nodename 

To stop the trace: F NET,NOTRACE,TYPE=10,ID=nodename 

Buffer Pool Usage (SMS) Trace. 

Takes a snapshot of information on buffer pool usage every 1000 
requests. Use this for evaluating buffer pool requirements. It must be 
used in conjunction with the SDAID facility (see below). 

To start the trace: F NET, TRACE, TYPE=SMS,ID=VTAMBUF 

To stop the trace: F NET,NOTRACE, TYPE=SMS, ID=VTAMBUF 


See the chapter 'Performance and Storage Requirements' in this manual 
for further details on its use. 


VTAM Internal Trace. 

This trace provides a record of events within ACF/VTAM itself such as 
scheduling of resources, storage management, and the flow of PIU's 
internally. This trace should be used if ACF/VTAM internal problems 
are suspected. 

To start the trace: F NET, TRACE, TYPE=VTAM,MODE=EXT,OPTION=ALL 

To stop the trace: F NET,NOTRACE, TYPE=VTAM, OPTION=ALL 


Note that "OPTION=" can select particular components for tracing. 
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9.5.1 Trace Collection 


Trace collection can be started through operator commands from the 
console, or by specifying options at ACF/VTAM startup. The trace informa- 
tion is written sequentially to disk or tape file. On disk, the newest 
trace records overlay the oldest when the file is filled. The ACF/VTAM 
startup JCL in this manual provides the necessary statements for a trace 
data collection file on disk. 


Trace data collection can be initiated from the console by use of the MOD- 
IFY TRACE command. Here is an example of its use to trace data on the LU 
*LOZOBOL' : 


F NET, TRACE, TYPE=BUF,ID=LO020B01 
This will start collection of data. 


After sufficient data has been collected, the following command will stop 
collection: 


F NET,NOTRACE, TYPE=BUF,ID=LO020B01 
Note that the command must be entered in full. 


Another option on the BUF and IO trace is 'SCOPE=ALL'; this will cause all 
subordinate resources to the specified node to be traced. For example, all 
the LU’s associated with a PU. 


Note: SDAID must be used in conjunction with the ACF/VTAM MODIFY command 
to collect SMS data. 


For a full description of the MODIFY TRACE command, see the ACF/VTAM V2 
Operation manual. Use of trace parameters in ACF/VTAM start options is 
described in the *Planning and Installation Reference’ manual. 


The BUF, I/0, and VTAM Internal Trace data can then be printed using the 
TPRINT utility. This can run as a subtask under ACF/VTAM or as a job step 
under VSE, however it is recommended that. it be run as a separate job step 
to avoid possible ACF/VTAM performance degradation. If the ACF/VTAM 
startup JCL provided in this manual is used, then the following statements 
can be used to invoke TPRINT: 


// JOB TRPRINT 

/7 DLBL TRFILE, 'VSEIPOE.SNA.VTAM. TRACE. FILE' 
77 EXTENT SYS004,SYSWK1,1,0,111770,500 

// ASSGN SYS004,241 | 

// ASSGN SYSLST,OOE 

77 EXEC TPRINT 


SYSLST can be assigned to a printer, tape or disk with IJSYSLS. 
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When the job is run, you will be prompted for options. The options can 
select type of data, source of data, a time interval, and whether or not 
to continue tracing afterwards. Example: | 


PRINT BUF=ALL,CLEAR=YES, INTERVAL=(18:00:00,18:05:00) | 


This will print all BUF records recorded between the times shown and start 
recording from the beginning of the file afterwards. A full description 
of trace options can be found in ACF/VTAM V2 Operation under the section 
*Trace Print Options’. 


Note: For printing out SMS data use DOSVSDMP (see below). 
Actual analysis of ACF/VTAM trace data is beyond the scope of this manual, 


however examples can be found in ACFE/VTAM V2 Diagnosis Guide and ACE/SNA 
System Problem Determination Guide (volumes 1 and 2). | 
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9.6 VSE TRACING AND DUMPING FACILITIES 


There are also a number of tracing and dumping facilities provided by VSE 
that can be used for problem determination in ACF/VTAM. These are: 


@ SDAID 

¢ DOSVSDMP 

° 4331 Communications Adapter Dynamic Trace 
e VSE DUMP Command 

° VSE CANCEL Command 


e Program Initiated. 


9.6.1 SDAID 


This program is invoked through the console by entering 'SDAID*. It can 
be used as a useful hands-on debugging tool to obtain information about 
the conditions prevailing at the time of a malfunction. Most of the tracy 
ing facilities for VSE are provided by this program. The resulting event 
records can be written into a wrap-around buffer, a onto a magnetic tape 
or straight to printer. Data written to a tape can be formatted and sent 
to a printer through the use of DOSVSDMP. SDAID can be requested to trace 
VSE/VTAM I70 related events (not to be confused with the ACF/VTAM I70 
trace). These include occurences of SVCs, SIO/SIOF instructions and I/0 
interrupts. 


SDAID must also be used in conjunction with the ACF/VTAM MODIFY command to 
enable collection of SMS data. | 


Here is an example of SDAID being used to collect SMS data. ACF/VTAM is 
started in F3 and the trace tape is mounted on unit 300. 


Enter from the console: 


sdaid 

AR 015 4CO5I PROCESSING OF "SDAID*® COMMAND SUCCESSFUL. 
area | 

AR 015 4CO8D SPECIFY TRACE AREA. 

15 3 | 

AR 015 4C08D SPECIFY TYPE OF LIMITS. 

15 (blank) 

AR 015 4C08D SPECIFY ADDITIONAL TRACE AREA. 

15 (blank) | 

AR 015 4C0O5I PROCESSING OF "AREA* COMMAND SUCCESSFUL. 
outdev 


AR 015 4CO8D SPECIFY OUTPUT DEVICE. 
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15 tape 

AR 015 4C08D SPECIFY PHYSICAL ADDRESS OF PRINTER/TAPE. 

15 300 

AR 015 4CO5I PROCESSING OF "OQUTDEV' COMMAND SUCCESSFUL. 

trace | 

AR 015 4CO0O8D SPECIFY TRACE TYPE. 

15 vtambu 

AR 015 4C08D SPECIFY OUTPUT. 

15 (blank) 

AR 015 4C08D SPECIFY OPTIONS. 

15 (blank) : | 

AR 015 4CO5I PROCESSING OF "TRACE" COMMAND SUCCESSFUL. 

ready 

AR 015 4CO5I PROCESSING OF 'READY’ COMMAND SUCCESSFUL. 

strtsd 

AR 015 4CO5I PROCESSING OF 'STRTSD* COMMAND SUCCESSFUL. 
ag ia SDAID IS STARTED AT THIS POINT ----- 

f net,trace,type=sms,id=vtambuf 

F3 017 5A97I TRACE ACCEPTED 

F3 017 SF13I TRACE INITIATED FOR NODE = VTAMBUF 

F3 017 5FO4I VTAM TRACE SUBTASK STARTED 
SS SMS TRACE IS NOW STARTED Se 
a= COLLECTION TAKES PLACE. SSS 
cla aaa TO STOP THE TRACE : sabesleteni 

f net,notrace,type=sms, id=vtambuf 

F3 017 SA97I NOTRACE ACCEPTED 

F3 017 5F1l2I TRACE TERMINATED FOR NODE = VTAMBUF 


aa eae TO STOP SDAID : = oo om mom me 
stopsd 
AR 015 4CO5I PROCESSING OF 'STOPSD' COMMAND SUCCESSFUL. 
Seas TO END SDAID : ee ore me 
endsd 


AR 015 4CO5I PROCESSING OF 'ENDSD' COMMAND SUCCESSFUL. 
----- SDAID IS NOW ENDED ----- 


9.6.2 DOSVSDMP 


The DOSVSDMP printing facility can be used to print the output of a 
stand-alone dump, a dump as the result of a DUMP command (tape or disk), 
or output from SDAID written to tape. Here is an example of its use in 
printing off the tape created in the SDAID section. A job with a PAUSE 
statement is released and Job Control is entered from the console. 


r rdr,pausebg 

BG 000 7/7 JOB PAUSEBG 

BG 000 // PAUSE 

0 // assgn sys006,300 

BG-000 0D16D READY 

0 // exec dosvsdmp 

BG 000 4C50D ENTER: OPTION #, ? FOR HELP, R FOR RETURN 
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1 CREATE DOSDMPF 2 PRT SA DUMP 3 PRT SDAIDTAPE 
4 PRT SYS DUMP OR SDAID BUFFER WRITTEN BY AR COMMAND 
5 CREATE DOSDMPG 6 CLR DOSDMPF 7 CLR DOSDMPG 
CENTER 1 OPTION ONLY) 
BG-000 
0 3 
BG 000 1100D READY FOR COMMUNICATIONS. 
0 7% 
BG 000 EOQJ PAUSEBG 


The DOSVSDMP stand-alone facility can be used whenever the severity of a 
malfunction Ce.g. hard wait) prevents the use of other dump facilities. It 
can create a stand-alone dump on cards, tape, diskette, or disk. The pro- 
gram needs to be generated under VSE before it can be used stand-alone. 
It is written to a device such as a tape or disk, and this is IPL'd for 
execution. 


9.6.3 4331 CA Dynamic Trace 


This facility can be used to activate a trace on a 4331 Communications 
Adapter, collect the data on tape, and deactivate the trace while the the 
attached teleprocessing line is still running. This trace records entries 
which provide information on the functioning of the CA hardware and micro- 
code, CCW commands, sense information and user data. The data is mainly 
for use by IBM personnel. 


The facility is invoked by first invoking the In Line Test from the 4331 
Maintenance Selection facility. The options can then be supplied through 
the MS facility or preferably through an OPTION control statement invoked 
by a jobstream. Here the JCL of a trace jobstream: 


“7 JOB XX 
/7 ASSGN SYSLST,cuu cuu=output 
// ASSGN SYS010,cuu cuu=tape work file 
// ASSGN SYS011,03B C03B=required 
// EXEC IDUSVEP 
PAUSE 
-~--- anter from console -------- 
OPTION 410nn >nn= subchannel to 
| be traced*? 
DYNADMP DYNAMIC >to trace dynamically 
OPTION 4linn >to stop the trace 
SYSIN >continue input from card reader 
PRINT 
END 
7% 
7% 
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A full description of the options available can be found in the VSE SADP 
manual in Chapter 2. | 


9.6.6 DUMP Command 


The DUMP command can be used to dump an area of storage. The format is: 
DUMP dumparea,cuu 

There are several options for 'dumparea'’, the default being a dump of gen- 
eral, control and floating point registers, and all activa partitions. 
Others, such as the supervisor, SVAs, and selective addresses may be 


selected. 


To dump the ACF/VTAM partition to tape, "dumparea’ is the partition Ce.g. 
F3) that ACF/VTAM is running in and ‘cuu’ is the address of the tape unit. 


The dump can be printed by using DOSVSDMP as described before, by select~ 
Ing opition 4. 


Swertiemrees | 


For more information on the DUMP options, see p.18 of the VSE SADP manual. 


9.6.5 CANCEL Command 


A dump can be specified by the operator when the VSE CANCEL command 1S 
used: it is processed as for the VSE DUMP command. 
Example: 


CANCEL F3,DUMP 


39 E.g. if you want to trace the CA for the line address 031, the sub- 
channel address to put here jis 31. 
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9.7 CONMON PROBLEMS 


9.7.1 ACF/VTAM Problems 


One af the most common problems with ACFE/VTAM operation relates to inade- 
quate buffers. This can result in such things as: 


° inability to start or terminate ACF/VTAM 

° ACF/VTAM abending or waiting 

° ACF/VTAM appearing to not accept commands 

° local devices not activating or communicating 
° inability to activate or deactivate a PU or LU 
e LU "hanging! 

e poor response time 

° message 5D80I1 being generated with sense 0812 


It is therefore essential to provide adaquate buffers for ACF/VTAM opera- 
tion in both normal and peak periods. 


In addition, it is essential to provide sufficient virtual storage area 
for these buffers tn the ACF/VTAM partition. This should be calculated as 
shown in ACE/VTAM Planning and Installation Reference, appendix F-11. 
ACF/VTAM needs sufficient space to operate within that partition as well, 
but do not use SIZE=AUTO on the EXEC statement; a SIZE of 1130K is recom 
mended. More information on these topics can be found in the chapter 
"Storage and Performance’ in this manual. | 


9.7.2 Link Related Problems 


Successful activation of a link (Cline) does not imply that the telecommu- 
nications facility is functioning correctly. Provided that the host-site 
modem is able to present Data Set Ready,» link activation may take place. 
When a link cannot be activated, it is frequently due to the modem being 
powered off, being faulty, or that the link to the modem is incomplete. 


Where VSE is running under VM make sure that the CA line is ATTACHed to VSE 
and DVCUP'd before attempting to activate the line from ACF/VTAM. Also 
check that the characteristics defined in the CA hardware, VSE and 
ACF/VTAM are consistent. 
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9.7.3 PU Related Problems 


PU related problems on installation frequently relate to inconsistencies 
between the definitions in ACF/VTAM and those in the PU. The sorts of 
things to look for are: | 


1. NRZI setting 

2. PU addressing 

3. XID identification Cswitched lines) 

4. control unit powered off or not IML'd 

5. faulty link(s) between modems or faulty modems 


6. faulty link€s) batween modem and PU 


9.7.4 LU Related problems 


These are generally either due to the LU not being in the correct status, 
or the LU being unable to establish a session with another Capplication) 
LU after the ACTIV status has been established. 


Usual problem determination techniques should be used to determine prob- 
lems with such things as LU hardware and softwara; e.g. through the use of 
ACF/VTAM displays and commands. Sometimes the LU may be shown as being 
inoperative (due to a fault or failure of some sort); the LU can sometimes 
be brought to ACTIV status by using the ACF/VTAM vary inactive command 
with the force option. This will change the status to INACT; a vary active 
command may then activate it: | 


¥ NET, INACT, ID=luname, F 
.--node will become inactive 


V NET,ACT,ID=lLuname 
-.-may restore the status to ACTIV 


Attention should be paid to the use of the 'ISTATUS=' parameter on the LU 
definition, so that operators know which LUs should be automatically acti- 
vated and which need to be activated through ACF/VTAM commands. 

The default ACF/VTAM USS message ‘SESSION NOT BOUND’ CUSS MSG 7) means 
that the LU has had session establishment rejected for some reason. This 
could be, for example: | 

@ the application is not accepting logons 

e the application has rejected the session parameters presented by 


ACF/VTAM 
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e the terminal has rejected the BIND with the session parameters | 
e a route 1s not available (for cross-domain connection) 


In addition, the terminal itself may indicate that a BIND has been 
rejected. The 3274 may show a '45n' number under the operator line on the 
LU's screen, for instance; this also indicates why the BIND was rejected. 


If a BIND rejection occurs, find out how the BIND is built - via a LOGMODE 
table, or via the application, or even via a combination of the two. Run 
an ACF/VTAM buffer trace to see the actual BIND flow and check to see if it 
differs from the expected BIND flow. Check the definitions for the termi- 
nal in the application, if present. In CICS this is the TCT, and the BIND 
image iS usually built from this. 


If you receive the USS message ‘parameter PARAMETER INVALID’ (CUSS MSG 4) 
it could mean that: 


° the application has not been started 

e the application has not been activated from ACF/VTAM 

° the application has not Cyet) opened its ACB 

° the cross domain definitions have not yet been activated 


A full description of USS messages and their meanings can be found in 
ACF/VTAM V2 Messages and Codes 


Note: 

With 3270s the screens have various model numbers, dependent upon the 
screen sizes. If a screen is plugged into a port which is defined for a 
model higher than itself, it can still be logged on but the number of 
lines/characters on the screen will remain the same. The overall image 
will be smaller. However, a smaller sized screen cannot be used ina port 
defined for a larger screen: an error message will appear on the display 
and logon will not complete. 
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9.8 FAILURE AND_BACKUP 


Planning for Failure, Backup and Recovery should be a part of the instal- 
lation process for an SNA network. Consideration should be given to the 
sorts of failures that can occur and the impact that these failures would 
have on the end users. Questions need to be considered such as: 


e What is the impact if a particular component (e.g. control unit) is 
down? | 


e What is the impact if there is a line outage - this may affect more 
than one component? 


® What is the maximum downtime before the situation becomes critical? 


e Does the potential impact on the organization justify the installa- 
tion of backup hardware or switched/leased lines? 


® Which terminals have critical access to which programs? 


Various facilities are available in ACF/VTAM that assist backup planning 
and recovery. 


9.8.1 Configuration Restart 


Configuration restart is an ACF/VTAM facility that maintains certain sta- 
tus information about ACF/VTAM resources, on data sets. In general, this 
information includes active/inactive status and operator~-specified values 
of activation and operating parameters. When restarting ACF/VTAM after a 
halt or failure, or when reactivating an individual major node after a 
deactivation or failure, ACF/VTAM can use this information to restore the 
resources to their status prior to the deactivation or failure. 


The information is stored in one or two files - the NODELST file and the 
configuration restart file. The NODELST file contains information about 
the status of major nodes; the configuration restart file contains infor- 
mation about changes made within major nodes. As the ACF/VTAM operator 
makes changes to these nodes, the changes are recorded in these files so 
that they reflect the current state of the network. 


When the operator restarts ACF/VTAM, he or she can specify that the start 
be : : 


1. COLD - which restarts ACF/VTAM to its initial status 
2. WARM ~- which restarts ACF/VTAM using : 


¢ the information contained in the configuration restart file, 
identified on the CONFIG operand 
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¢ the information contained in the NODELST file, identified on the 
NODELST operand | 


Both operands are specified in the ACF/VTAM startup parameters. 


Both the NODELST and the configuration restart files are VSAM files. 
Information on defining these can be found in the manual ACFE/VTAM V2 Plan- 


nin 


and Installation Reference, along with more detailed information on 


Configuration Restart. 


9.8.2 Link Failure Backup 


Where critical links exist, switched lines can often be used to provide 
backup to the primary, non-switched link. There are a fen different ways 
to achieve this: 


Ls 


through the use of an alternative set of modems to provide a manual, 
switched connection. After having changed the CA hardware definition 
to switched via the CA configuration screen, the line is reactivated 
with the original ACF/VTAM definitions and operated as a non-switched 
line, as usual. 


through the use of modems with the Switched Network BackUp (SNBU) fea- 
ture, where the modems can provide a switched facility and be used in 
a similar manner to 1. In this case, the CA definitions do not have to 
be changed; once the modems have established the switched connection, 
the line is operated as a leased line. For details see Chapter 7, sec- 
tion "Switched Network Back-Up’. 


where an alternative CA port is available, it can be set up as having 
a switched line. Alternative sets of CA definitions can be provided 
for this port and in the event of a leased line failure, a switched 
connection can be made to the remote location by using this line. 
This is done by deactivating the original set of leased line defi- 
nitions and activating the relevant set of switched definitions. The 
sama LU definitions are used in the backup switched definitions as in 
the non~switched definitions. | 


The control unit has to be set to switched mode. 


if modems with the switched line backup feature are used (not to be 
confused with SNBU), an alternative, set of switched definitions can 
be provided for the line using the same LU names as for the 
non-switched line. In the evant of non-switched line failure, the ori- 
ginal definitions can be deactivated, the modems and the CA changed to 
provide switched connection, and the switched definitions activated. 


The control unit has to be set to switched mode. In case of an IBM 
3276 flip the SNBU switch, which is a confusing name for it. 
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5. where multiple peripheral links run to a remote location from one 
4300, it is possible to have an alternative set of definitions multi- 
dropping the PUs in various combinations. In the event of failure of a 
link, the definitions for that link and its PUCs) could be deactivated 
and definitions which include the PUCs) on another line could be acti- — 
vated. The site would need a hardware multidropping facility of some 
sort Ce.g. splitter modems or a modem-sharing unit). 


Pay attention as to whether the facilities are physical half-duplex or 
duplex. Some switched facilities only provide for half-duplex connection 
and switched duplex connection requires TWO connections through special 
modems. Some countries provide a switched, full-duplex connection. 


Note: 
All the mathods above can be used to provide backup for peripheral links, | 
but note that cross-subarea links, that is, links between two 4331/4321's 
or between a 4321/4331 and an IBM 3705, do not support switched defi- 
nitions. However cross-subarea links can make use of a switched line by 
the use of modems with the SNBU feature (method 2). See Chapter 7, sec- 
tion Switched Network Back-Up’ for details. 
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9.9 _ GENERAL GUIDELINES 


It is recommended that the person who is responsible for problem determi- 
nation in an SNA network receive at least some basic education in SNA, 
either through IBM Independent Study Programs or through scheduled class- 
es. In addition there are manuals which are available to assist with 
problem determination, such as ACF/SNA System Problem Determination Guide 
volumes i and 2. These can be used in conjunction with ACF/VTAM V2 Diagno- 
sis Guide and SNA reference manuals to provide a comprehensive means of 
dealing with SNA network problems. 


The use of Communication Network Management Products can greatly simplify 
the operation of a network and assist with online problem determination. 
IBM's NPDA is the product which is used for problem determination, and 
this runs under NCCF. A description and guide to installation of NCCF and 
NPDA can be found in the "CNM Customization' chapter in this manual. Fur- 
ther information on the use of CNM tools can be found in the document 


Communication Network Management: Using the CNM Tools. 
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10.0 ACF/VTAME TO ACF/VTAM V2 MIGRATION 


This chapter provides information that you will need for migrating to 
ACF/VTAM V2 from ACF/VTAME. 


The following topics are discussed: 
e new functions 

° changes from ACF/VTAME 

° migration configurations 

° coexistence 


If you need more detailed information please refer to the ACFE/VTAM Plan- 
ning and Installation Reference manual, Chapter 13: Migration. 


10.1 NEW FUNCTIONS 


ACF/VTAM V2 has the following major new functions over ACF/VTAME: 


10.1.1] New Routing Structure 


In an ACF/VTAME multi domain environment the user had to define 
cross-domain PATH statements to provide for the routing of messages to 
different subareas. Only paths to subareas which were not adjacent to the 
originating subarea had to be defined. | 


ACF/VTAM V2 introduces a new way to define the routes ina single or multi 
domain environment. 


The following terms are used to describe the new routing structure: 
e Transmission Groups 

® Parallel links 

e Explicit Routes 

® Virtual Routes 

e Multiple CAlternate) Routes 


© Transmission Priority Levels 
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® Class of Service 


The user can define from one to eight logical communication paths between 
adjacent subareas in a network. These logical links are called trans- 
mission groups (TGs). 


There may be only one TG (TG number 1 or TG1) between the following sub- 
areas: | 


e a host processor and an ACF/NCP attached by a channel 


® a host processor and an ACF/NCP attached by an SDLC link through a 
Communication Adapter 


e two host processors attached by an SDLC Link through Communication 
Adapters 


Up to eight TGs can be defined between two ACF/NCPs which are connected by 
one or more SDLC links. 


Each TG consists of ona or more links called parallel links . If ona or 
more of the links in a TG fail, session traffic continues over the remain- 
ing links itn the group without loss of data. | 


Note: 
In a 43X1 CA eno neonmane only one TG can be defined between two subareas. 
This single TG may only contain Gn@ link (no parallel links). 


When a session is established, a network communication path called a route 
is used. This route may be considered at a Physical and a logical level. 
Routes at the physical level are called explicit routes (ERS). An ER isa 
sequence of physical network elements over which two subareas 
communicate. Physical elements include host processors, communication 
processors, and links which connect them. Therefore, an ER consists of the 
origin. subarea, intermediate TGCs) Cand subareas), and the destination 
subarea. 


Up to eight ERs CERO - ER7) can be defined between any two subareas, 
therefore allowing the definition of multiple or alternate routes via dif- 
ferent intermediate subareas. This provides for higher availability in 
the case of failure of some route elements. 


Routes at the logical level are called virtual routes (VRs) .A VR is a 
logical connection between two subareas that participate in a session. 
Each VR is assigned to an ER Cand is therefore dafined as VRO - VR7). 


Each VR provides the user with a particular transmission priority. 
ACF/VTAM V2 provides 3 levels of transmission priority (TPO - TP2), where 
0 is the lowest priority. Data on VRs with higher priority can be sent 
ahead of data on VRs with lower priority. 


Notes 


These different priorities are not implemented over links connected 
through a CA. 
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The VR to be used for a session is selected through the class of service 
(COS), which is specified in the LOGMODE table for this session. The COS 
is a list of VRs and associated TPs that have been defined between two 
subareas. The COS will be selected from a user defined COSTABLE or froma 
default COS algorithm. 


10.1.2 Route Test 


In ACF/VTAME the VTAM operator could display the defined paths with the D 
NET,;PATHTAB command. 


This is still true in ACF/VTAM V2. Additionally, the VTAM operator can use 
the D NET,ROUTE,... command to display the defined routes and to test if 
a route is operative. A test message is sent along the route resulting in 
a reply that indicates whether the route is available. If the test message 
cannot be sent along the entire route, the reply to the operator includes 
information to locate the tnoperative part of the route. 


19.1.3 Route and Session Failure Notification 


If a VR or ER fails, the sessions assigned to that VR or those VRs which 
are associated with that ER are disrupted. In all ACF/VTAM host subareas 
the operator will be notified of that route failure, so that corrective 
action can be taken to make the route active again. 


Also session failure notifications will be generated for both ends of the 
session (e.g. the application program). Reason codes will ba supplied to 
be used in determining the cause of the failure as well as if the session 
should be restarted. 


10.1.4 Dynamic CDRSC Definitions 


In ACF/VTAME an LU CLUA) in domain A which could have a session with a 
resource CLUB) in domain B had to be defined as a CDRSC in domain B, and 
LUB had to ba defined as a CDRSC in domain A. 


ACF/VTAM V2 allows a dynamic definition of one side of the session part- 
ners. During a session setup the LU which initiates the session request is 
the requesting LU, the other side is the requested LU. 


Only the requested LU (the destination of the session request) has to be 
predefined in the host of the requesting LU. The requesting LU (the origin 
ef the session request) does not need to be predefined in the host of the 
requested LU, as the necessary information about the requesting LU can be 
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found in the session request command, and the definition will be dynam- 
ically built. 


This dynamic definition has to be authorized in the CDRM definition state- 
ment of both hosts. This implies that both hosts have to be at ACF/VTAM V2 
lavel. 


Figure 31 illustrates the necessary definitions. 


HOST A HOST B 
CICSA -CICsB 
ACF/VTAM V2 ACF/VTAM V2 


1. LUA logs on to CICSB 
2. CICSA acquires LUB1 Cprinter with LOGAPPL=CICSA) 
3. LUB2 logs on to CICSA 


Requesting LU Requested LU 


CDRSC definitions in 


HOST A HOST B 


CICSB CDRSC CICSA CDRSC 
LUB2 CDRSC 
CLUB1 CDRSC) CLUA CDRSC) 


Figure 31. Example of Dynamic CDRSC Definition 


Note: 


Definitions in parentheses show additional definitions required Without 
dynamic CDRSC definition. 
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10.1.5 Support of new functions of CICcS/VS 1.6. 


ACF/VTAM V2 is the base for enhanced sessions which CICS/VS 1.6 can set up 
with nen terminals Coffice systems) and other CcIcss. 


10.1.6 Support of the IBM 3705 on an IBM 4331 Channel 


In addition to devices attached via links on the CA, ACF/VTAM V2 now sup- 
ports a channel-attached 3705 controller and all the devices connected to 
it. 


Thereby, ACF/VTAM V2 combines the functions of ACF/VTAME and ACF/VTAM F2 
or R3. 


This allows to expand the network beyond the limits of the CA to the num- 
ber of lines attachable to a 3705 without the need to migrate to another 
VTAM version. 

It also allows better backup facilities for host failures. An IBM 4331 can 


now take over parts of a network whose host has failed, provided that both 
hosts share the NCP to which the network is attached. 


10.1.7 Configuration Restart 
Configuration restart is an ACF/VTAM facility that maintains information 
that an operator can use to reactivate a network to a pre-failure status. 


The user can define VSAM datasets where minor and major node activation 
and deactivation are recorded. 


The configuration restart is initiated by the operator after 
e an ACF/VTAM failure, 
@ a host operating system or processor failure, 


e® a communication controller or an NCP failure from which VTAM did not 
immediately recover, 


® deactivation of a domain in the network by the operator. 


ACF/VTAM will then restart the network to its status Cactive or inactive) 
before the failure occurred. 
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10.2 CHANGES FROM ACF/VTAME 


The following changes have to be made when migrating from ACF/VTAME to 
ACF/VTAM V2. Only those changes required to prevent definition errors and 
to allow proper operation are listed. 


Optional changes which would invoke new functions are not listed. Please 


refer to the Planning and Installation Reference Manual, chapter 13: 'Mi- 
gration" for a complete list of changes. | 


Do not change definitions which belong to the production system. 

It is recommended that you copy tha whole existing ACF/VTAM related proce- 
dures, jobs, etc. into a different ICCF library, then rename the ICCF 
members and change the job names. The names should have a reference to 
ACF/VTAM V2, ea.g., the CATAL job for ACF/VTAM V2"'s ATCSTROO is named 
V2STROOC. 


Change in all these jobs the 'TO0 library’ from USRxL1 to USRxL2. 
ACF/VTAM related assembly/link jobs have LIBDEF SEARCH chains, which have 
PRDxLG in front of PRDxLC! 


If not available, create the USRxl2 library set via the IPF Dialogs. 
Now modify the definitions as mentioned below and submit the updated mem- 
bers to VSE. 


Beware, that the ACF/VTAM V2 start job, the CICS/VS start job and other 
ACF/VTAM application start jobs have changed LIBDEF SEARCH chains, PRDxLG 
in front of the PRDxLC, USRxL2 in front of USRxL1. 


When ACF/VTAM ¥2 is active, release only ACF/VTAM application start jobs, 
which have the changed LIBDEF SEARCH chain. Otherwise these applications 
will fail. 


ACF/VTAM V2 requires VSE/AF Release 3. If you migrate from ACF/VTAME and 
still area at a lower release level of VSE, you have to migrate to the 
required VSE release first. 


19.2.2 CNM Applications 


ACF/VTAM V2 only supports NCCF Rel.2. If you migrate from ACF/VTAME and 
still are at a lower release level of NCCF, you have to migrate to the 
required NCCF release. You can do that first under ACF/VTAME. 


Raleigh International Systems Center 
10.2.3 IPL. Definitions 


You can use the same IPL definitions as in the ACF/VTAME anvironment. 


10.2.% Startup Definitions 


ACF/VTAM V2 requires more storage in the ALLOC and ALLOCR statements than 
for VTAM7E. If you used the storage estimates in the ACF/VTAME Installa- 
tion manual to determine the space requirements precisely, repeat the 


estimates with the formulae from ACE/VTAM V2 Planning and Installation 
Reference. 


Do not use SIZE=AUTO for the EXEC statement on the VTAM startup deck. The 
correct value is 1130K. See the Chapter 8 for details. 


Otherwise use the values given in Chapter “5S, section "Startup 
Definitions’. These values should provide space for a medium to large size 
network. 


10.2.5 USS Table CUSSTAB) 


ACF/VTAME was able to segment data which were sent over the SSCP-LU ses- 
sion Cae.g. USS messages) to the terminal. This facility could be used to 
send full-screen messages (e.g. USSMSG 10) to terminals whose input buffer 
was smaller than the data size. 


This is no longer true in ACF/VTAM V2. Now, the maximum RU size Cdata plus 
SNA headers) may not exceed the device buffer size. This implies that the 
former full-screen USS messages have to be shortened to maximum buffersize 
(e.g. 256 bytes for remote SNA devices). 

Note: 

This applies only for the SSCP-LU session (not for the LU-LU session) and 


for locally and remotely (via a CA line) attached devices Cnot for NCP 
attached devices, as the NCP will perform the segmentation). 


10.2.6 ACF/VTAM Definitions 


The following definition statements have changed from ACF/VTAME: 
Local davices 


Your existing LOCAL statements may need the following changes: 
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> The (NO)SELPEN parameter of the FEATURE2 operand is no longer valid. 

® The CNOJEDATS parameter of the FEATURE2 operand has been added for 
| devices with extended data stream Ce.g. 8775 with graphics support). 
Remote devices 

The GROUP statement for CA attached devices may need to be changed: 


e There is no default value for LNCTL Cformerly SDLC). If you have an 
SDLC lina you have to code LNCTL=SDLC. 


The LINE or GROUP statement needs to be changed: 
e The INBFRS operand has been replaced by MAXBFRU. 
e The (CNO)SELPEN parameter of the FEATURE2 operand is no longer valid. 


Application programs 


The CNIVPACE parameter of the AUTH operand in the APPL statement has bean 
addad. 


PATH statements 


PATH statements must be coded also for cross domain routes where the des~ 
tination subarea is the adjacent subarea. Additionally, the noche of the 
PATH statements has changed. 


10.2.7 Start Options 


° The UECB buffer pool is no longer used. Therefore, if you have 
defined it for VTAM”E, delete this buffer definition from your start 
list(s). The VPBUF may need to be increased by an amount similar to 
that of the old UECB buffer. 


e The default base number and buffer size of the other buffers have 
changed. If you have user defined buffer values, change them or let 
them default to reflect the new buffer size and base number. See chap- 
ter eight of this manual. 


10.2.8 ACF/VIAM Start Job 


Pick up your production system ACF/VTAME start job C€prepared as mentioned 
above) and change the LIBDEF SEARCH chains in this job.: 
Replace PRDxLC by PRDxLG, USRxL1 by USRxL2! 
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10.2.9 Operator Commands and Messages 


The syntax of the MODIFY and the DISPLAY STATIONS command has changed. 
Refer to the ACF/VTAM V2 Operation manual for details. 


The differences, however, should cause no migration concern, because the 
old format of the commands will also be accepted. 


10.2.10 Test of Your Customized ACF/VTAM V2 Definitions. 


Go to the same section in Chapter 5 and return after completion of the 
described tests. 


10.2.1] CICcs/vs 


You have to change only your CICS/VS start job. Pick up your production 
system CICS/VS start job Cprepared as mentioned above) and change the LIB- 
DEF SEARCH chains in this job: 
PRDxLG in front of the PRDxLC! 


Submit the job into the VSE/POWER queue and release after ACF/VTAM V2 is 
activa. : 


10.2.12 Test of CICS/VS With ACF/VTAM V2 Definitions. 

Go to the same section in Chapter 5 and return after completion of the 
described tests. 

If the tests are correct, you may use ACF/VTAM V2 in production. After 
some production days you may delete your ACF/VTAME from the PRDxLC library 


set. 


You also may replace (CORGZ) the ACF/VTAME definitions in USRxL1 by the 
ACF/VTAM V2 definitions of USRxL2. 


If you do this, do not forget to correct the LIBDEF SEARCH chains. 
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10.3 MIGRATION CONFIGURATIONS 


Configurations containing ACF/VTAME nodes that are providing an ‘'IRN' 
routing function must be migrated to ACF/VTAM V2 in a specific order. IRN 
CIntermediate Routing Node), formerly called INN CIntermediate Networking 
Node) means that this host is neither the origin nor the destination for 
data passing through this node. 


The order of ACF/VTAME node migration must be as follows: 


ACF/VTAME nodes that are not providing an IRN routing function may be 
migrated to ACF/VTAM V2 one at a time. If these ACF/VTAME nodes are 
upstream connected (via an NCP to a host), the adjacent ACF/NCP nodes may 
also be migrated to ACF/NCP R3 Cor higher) one at a time. 


All peer connected ACF/VTAME nodes that are providing an IRN routing func~ 
tion must be migrated to ACF/VTAM V2 simultaneously after all non-IRN 
ACF/VTAME nodes have been migrated. If these ACF/VTAME nodes are upstream 
connected, the adjacent ACF/NCP nodes must also have been migrated to 
ACF/NCP R3 Cor up). | 


Examples of non-IRN Node Migration . 


Figure 32 shows a peer connected ACF/VTAME configuration where neither 
HOST1 nor HOST2 provides an IRN function. Both hosts can migrate to 
ACF/VTAM V2 one at a time. | 


Figure 32. Peer Non-IRN Configuration 
Figure 33 on page 173 shows a upstream connected ACF/VTAME configuration 


where HOST1 is not providing an IRN function. HOST1 can migrate to 
ACF/VTAM V2 and NCP2 can migrate to ACF/NCP R3 Cor up) one at a time. 
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Figure 33. Upstream Non-IRN Configuration 


Examples of IRN Node Migration 


Figure 34 shows a peer connected ACF/VTAME configuration where HOST2 pro- 
vides an IRN function. HOST2 cannot migrate to ACF/VTAM V2 unless HOST1 
and HOST3 have been migrated to ACF/VTAM V2. 


HOST1 HOSTS 


Figure 34. Peer IRN Configuration 
Figure 35 shows a upstream connected ACF/VTAME configuration where HOST2 
is providing an IRN function. HOST2 cannot migrate to ACF/VTAM V2 unless 


HOST1 has been migrated to ACF/VTAM V2 and NCP3 has been migrated to 
ACF/NCP R3 Cor up). 


NCPS | HOST3 
Po eee 


Figure 35. Upstream IRN Configuration 
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10.4 COEXISTENCE OF ACF/VTAME AND ACF/VTAM V2R1 


In a multi-domain network ACF/VTAME and pene aunr V2 nodes can coexist and 
can he connected peer-to-peer. 


There are some items which have to be considered in such an environment. 
They will ba described separately from the viewpoint of each side. 


ACE/VTAME 
Whether or not ACF/VTAME is connected to another ACF/VTAME or ACF/VTAM V2 


is transparent to ACF/VTAME. There are no definition changes in ACF/VTAME 
if it is connected to an ACF/VTAM V2. 


ACE/VTAM Ve 


For ACF/VTAM V2 an ACF/VTAME node is a migration node. This implies that 
certain restrictions apply: 


As ACF/VTAME does not support the new routing structure, only ERO and VRO 
(the migration route) may be defined as routes between ACF/VTAM V2 and 
ACF/VTAME. This also implies that there are no alternate routes to a 
migration node. | 


As ACF/VTAME does not support the dynamic CDRSC definition, all CDRSCs in 
both ACF/VTAM V2 and ACF/VTAME have to be defined statically. 


174 


Raleigh International Systems Center 


11.0 SBTAM-ES TO ACF/VTAM Ve MIGRATION 


It 


is assumed that the user has an IBM 4331 with locally and remotely 


attached IBM 3270s. CICS/VS is running with BTAM-ES or the terminals are 
driven by BTAM application programs. 


This chapter contains information about the migration steps necessary to 
run the existing network with ACF/VTAM and CICS/VS. 


Li.j]_ PREREQUISITES TO THIS CHAPTER 


There are many ways to migrate from BTAM-ES to ACF/VTAM. 


Ls 


You define all non-SNA IBM 3270s to ACF/VTAM and migrate your applica- 
tions immediately. 


To ease the transition from BTAM-ES to ACF/VTAM, you may want to do in 
two stages: 
Existing non-SNA IBM 3270 tarminals continue to run with BITAM-ES. 


e Existing application programs that use BTAM macros directly need 
not be changed, but assigned terminals and lines can only be used 
by the partition in which the application is running. All new SNA 
terminals cannot work with these applications. 


@ CICS/VS definitions must be expanded so that CICS/VS can run with 
7 BTAM-ES and ACF/VTAM. 


All new SNA terminals are defined as ACF/VTAM resources. The 
non-SNA terminals are dafined as before but you have all the dis- 


advantages of assigned BTAM devices. 


In a second stage all non-SNA IBM 3270 devices will be attached to 
ACF/VTAM. 


° Recode the BTAM application programs to CICS/VS application pro- 
grams and make the CICS/VS tailoring. 


e Define the non-SNA devices to CICS/VS. 


With this method you will resume production faster but you have to do 
a lot of work twice. 
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11.1.1 Hardware 


It is assumed that the environment is in production state. The attached 
terminals, control units and modems are operating. 

You have prepared the Configuration Documentation Sheet as described in 
Chapter 3. 


11.1.2 Softnare 


The installation of ACF/VTAM is completed as described in Chapter 4. 


You have copied all ACF/VTAM definition books from the SIPO/E 3.1 SAMPLIB. 
to the ADMINISTRATOR-LIB. Following CICS/VS-production tables 


° DFHPCTxx 
° DFHPPTxx 
e  DFHSITxx 
° DFHTCTxx 
and the CICS/VS start job are reproduced and available with different mem- 
ber names in the ADMINISTRATOR-LIB. One example is PCTSVCAT in a single 


system environment. 


Do not mix your migration definitions with your production definitions, 
but create a separate test environment. 


11.1.3 Application Programs 


Existing application programs that use BTAM macros directly must be 
rewritten with ACF/VTAM macros to operate with ACF/VTAM or you convert 
these BTAM application programs into CICS/VS application programs. 


Application programs that use an IBM application subsystem such as CICS/VS 
should require few changes, if any, to run on ACF/VTAM. 
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11.1.4 Naming Conventions 


Before you start with any ACF/VTAM or CICS/VS definitions you should 
choose your naming conventions depending on your environment whether it be 
Single or multi system. 


Go to the chapter which matches your environment. 
Read this chapter to the section "Definitions’' and return. 


Fill the noda names into your Configuration Documentation Sheets and con- 
tinue with the next steps. 


11.2 IPL DEFINITIONS 


If you make a migration without adding new devices there is no need to 
change your IPL procedure. Otherwise go to Chapter 5, section "IPL Defi- 
nitions' and add the new devices/lines in a renamed copy (e.g. SIPLVT) of 
your existing ASI-IPL procedure. 


11.3. ACF/VTAM JOB PRIORITY 


The partition containing ACF/VTAM should have higher priority than the 
CICS/VS partitions, therefore go to Chapter 5 section ‘Startup Defi- 
nitions’ and include the recommended changes in renamed copies (e.g. 
SxJCLVT) of your existing ASI-JCL procedures. Submit the job and return 
to continue with the next steps. | 


11.4 ACF/VTAM DEFINITIONS 


Go to the chapter which matches your environment, section "ACF/VTAM Defi- 
nitions’ and define your ACF/VTAM major and minor nodes. 

Use the SIPO/VE 3.1 supplied ACF/VTAM books and modify them as described in 
this section. 


Beware, that on a switched line, the CA only supports SDLC IBM 3270's with 
ACF/VTAM. | 


Return and continue with the next steps. 
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11.4.1 Selecting ACF/VTAM Start Options 


Go to the chapter which matches your environment, section ‘Selecting 
ACF/VTAM Start Options’ and return to the next steps. 


11.5 TEST CF YOUR CUSTOMIZED ACF/VTAM DEFINITIONS 
Now you are ready to test your definitions. 
Be sure that the: 


° procedures and B.books are cataloged in USRSL1 as recommended in the 
previous steps, 


° USSTAB(S) are cataloged in the USRCL1 Cif necessary in your environ- 
ment); 


° ACF/VTAM start job is submitted, 


° devices and lines you want to test are not assigned to other parti-~ 
tions, 


e active ASI-IPL/JCL procedures reflect the network and the ACF/VTAM 
requirements. 


11.6 CIes/vS DEFINITIONS 


The main task to be performed is the modification of the CICS/VS tables. 
The table which interfaces with ACF/VTAM in defining the communication 
environment of CICS/VS is the 

DFHTCTxx 

But also the following tables have to be modified: 

DFHPCTxx 


DFHPPTxx 
DFHSITxx 


Pick up the catal jobs of these tables (Cprepared as mentioned at the 
beginning of this chapter) and modify them as described below. 
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11.6.1 Terminal Control Table Generation 


DFHTCT TYPE=INITIAL macro 


Exchange the entire macro with the DFHTCTSO INITIAL macro. 
If desired modify APPLID and GMTEXT. 

APPLID has to reflect the name chosen in the APPL minor node. 
SUFFIX has to be different to your production TCT suffix. 


DFHTCT TYPE=SDSCI/LINE/TERMINAL macros describing the console: 
There is no need to change the console describing macros. 
DFHTCT TYPE=SDSCI/LINE macros preceding user terminals: 

Delete these macros, they are not longer necessary. 

DFTRMLST AUTONLST/OPENLST 

Delete these definitions, they are not longer necessary 

DFHTCT TYPE=TERMINAL macros describing IBM 3270s: 

Add 


ACCMETH=VTAM 

GMMSG=YES 

NETNAME=minor node name (Cused in the LU, LOCAL, TERMINAL macro) 
RELREQ=(NO, YES) 


Change 


LASTTRM=POOL/LINE to LASTTRM=VTAM in the last terminal defined in this TCT 
TRMIDNT=xxxx corresponding to your naming conventions 


Delete 


COMPAT=NO 

LASTTRM=POOL/LINE in the last terminal macro of a pool/line 
LVUNIT=x 

~POLLPOS=x 

TRMADDR=xxxx 

TRMPRTY=0 


Note: 

As IBM 3270 terminals are the only non-SNA terminals supported by 
ACF/VTAM, the definitions of all other devices remain unchanged. These 
devices have to be defined prior to the first. ACF/VTAM terminal 
definition. If these devices are attached to a CA lina, this line must run 
under BTAM-ES control. 7 
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If you have a multipoint line with non-IBM 3270s and IBM 3270 terminals 
attached to it, all terminals must be defined as before. Beware that ona 
switched line, the CA only supports SDLC IBM 3270s with ACF/VTAM. 


New SNA/SDLC devices have to be defined as described in Chapter 5, section 
'CICS/VS Definitions’. | 


11.6.2 Program Control Table Generation 


Beware, that the following GROUP entries are in your renamed table: 


RESEND DFHPCT TYPE=GROUP, X 


FN=RESEND 

RESPLOG DFHPCT TYPE=GROUP, x 
FN=RESPLOG 

VTAM DFHPCT TYPE=GROUP, X 
FN=VTAM | 

VTAMPRT DFHPCT TYPE=GROUP, Xx 
FN=VTAMPRT 


Otherwise you have to expand your prepared PCT catal job with these 
entrias. | 


11.6.3 Program Processing Table Generation 


Beware, that the following GROUP entries are in your renamed table: 


RESEND DFHPPT TYPE=GROUP, X 
FN=RESEND 

RESPLOG DFHPPT TYPE=GROUP, x 
FN=RESPLOG 

VTAM DFHPPT TYPE=GROUP, X 
FN=VTAM 

VTAMPRT DFHPPT TYPE=GROUP, X 

| FN=VTAMPRT : | 


Otherwise you have to expand your prepared PPT catal job with these 
entries. 


Users with a generated Terminal Error Program refer to: CICS/VS System 


Programmer Reference Manual for how to generate the ACF/VTAM Node Error 
Program. | 
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11.6.% System Initialization Table Generation 


Change your prepared SIT catal job as described below. 


PCT=xx VTAM PCT 
PPT=(xx, COLD) VTAM PPT 
TCP=E$ 
TCT=Cxx, COLD) VTAM TCT 
ZCP=ES$ 


11.6.5 Cres/VvS Execution 


Take your reproduced and renamed CICS/VS production job, and change it as 
shown below: | 


* $$ JOB JNM=IVFCVxx, DISP=L,CLASS=2 
4/7 JOB ICVCVxx 


oe 8 © &@ @ @ 


e@eee#?e# 


SIT=xx 

7¥ 

/& 

¥* $$ EOJ 

Note: 
xx = $V in a Single System Environment 
xx = subarea number in a Multi System Environment 


Submit this job into the POWER/VS reader queue and release it after 
ACF/VTAM is started. 


11.7 TEST OF YOUR CUSTONIZED CiICcS/VS DEFINITIONS 


Go to the same section in Chapter 5 and continue as described there. 

If your CICS/VS is running only with ACF/VTAM you may delete your BTAM-ES 
from the SIPO/E 3.1 library sets after some production days. Thereafter, 
your CICS/VS BTAM-ES environment will not run any more. | 


If you have added only new SNA terminals to CICS/VS, you start with the 


definitions of your non-SNA 3270s in ACF/VTAM and CICS/VS now. Follow 
again the sequence described earlier. 
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12.0 CNM CUSTOMIZATION 


This chapter is to aid in the implementation and tailoring of NCCF, NPDA 
and VSE/OCCF. Additional information can be found in the document Communi- 


cation Network Management: Using the CNM Tools. 


The following sections describe the customization sequence via definition 
jobs from the SIPO/E 3.1 SAMPLIB. 

You should have copied these jobs to your ADMINISTRATOR Lib and prepared | 
as mentioned in Chapter 4. You should review these job streams to deter- 
mine how they are applicable to your needs. | 


The installation process is not described in this primer, as it is part of 
the SIPO/E 3.1 IPF Install Product Dialogs. 


Refer to IPF VSE Feature User's Guide Rel. 4. » page 85 Cinstall 


Products), for more information. 
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12.1 NETWORK COMMUNICATION CONTROL FACILITY (NCCF) 


The SIPO/E 3.1 contains NCCF Release 2 (5735-XX6). 


NCCF is a program product designed to let you control, record and automate. 
various network operator tasks. It runs as an ACF/VTAM application program 
and provides a base for IBM's Communication Network Management program 
products. 


NCCF allows the control of the network to be removed from the main system 
console and be placed on one or more other terminals in the network, 
either in the same or different domains. In addition, the optional fea- 
ture 'Terminal Access Facility’ allows you to use the NCCF terminal to 
communicate with CICS, HCF or a remote NCCF. TAF allows any combination of 
these subsystems to be controlled simultaneously from one NCCF terminal 
without requiring the operator to log off NCCF or to use separate, dedi- 
cated NCCF terminals for controlling each subsystem. Remote NCCF access 
can also be obtained by use of the NCCF-NCCF cross-domain ability, where 
one NCCF program establishes a session with another NCCF in another 
domain. In either way, control of a multi-systems network can be provided 
from a single screen logged on to one NCCF program. 


The facilities provided by NCCF allow you to streamline the daily opera- 
tion of your network by providing the ability to write your onn command 
lists, command processors, exit routines and subtasks. 


Command Lists 


Command lists, or CLISTS, contain sequences of ACF/VTAM, NCCF and 
user-written commands stored ina file. These CLISTS can be invoked by the 
NCCF operator or by the solicited or unsolicited messages received from 
ACF/VTAM. Here is an example of a simple NCCF CLIST: 


FORCE CLIST 
NET, INACT, ID=&1,F 
D NET,E,ID=&1 
&EXIT 


If the operator enters "FORCE LO20B01', LO20B01 will replace the &1 in the 
CLIST and the two ACF/VTAM commands will be executed. Use of CLISTS can 
greatly shorten the number and length of commands that an operator needs 
to anter. | 


Command Processors 

NCCF command processors can be user written or supplied by IBM. They allow 
the user to tailor, modify and extend the NCCF program. The command pro- 
cessors are written in assembler language, assembled, link edited into 


phases and the name is included in the NCCF definitions. 


Various facilities are provided by NCCF for writing command processors and 
a complete guide can be found in the NCCF Customization manual. 
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One example of an IBM-supplied NCCF command processor is Network Problem 
Determination Application (NPDA) which is described later in this 
chapter. 


Exit Routines 


User-written exit routines can be called from various points in NCCF proc- 
essing. These allow such facilities as PF key definition for CLISTS, con- 
sole message manipulation and message logging to hard-copy. 


Subtasks 


User written subtasks may be written to further customize NCCF. For exam- 
ple, a subtask may be written to centralize a process that would be used 
by several different subtasks, such as access to a database. 


Complete information on the above facilities can be found in the NCCF Cus- 
tomization manual. 


Note: 
The NCCF Installation manual should be used as a reference during the 
installation process. 


12.1.1 Naming Conventions 


Before you do your NCCF definitions you should decide on a naming conven 
tion for the NCCF definitions, particularly if you are working in a 
cross-domain environment. The following naming convention is suggested: 


NCCF operators OPss#N1 
NCCF main task AssNl 


NCCF POI task AssNiPPT 

NCCF operator AssN1000 

station tasks te 
AssNinnn 


Figure 36. NCCF Naming Convention 


O = Operator 

N = NCCF 

SS = subarea number 

# $= sequence number 

A = application 

PPT = primary POI taskCACF/VTAM Program Operator Interface) 
nnn = maximum number of operator station tasks 
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12.1.2 JCL Startup Statements 


- NCCF must run ina partition with a priority second to ACF/VTAM: 


e.g. PRTY FB,FA,F9,F8,F7,F6,F5,BG,F2,F4,F3,F1 


F3 = ACF/VTAM 
FG = NCCF 
Fil = VSE/POWER 
F2 = CICS/VS 
etc. 
Note: 


If you are going to use OCCF, see the section on OCCF in this chapter. 


The SAMPLIB member NCNPST is an example of a job stream that will start 
NCCF in F4. 


x $$ JOB JNM= NISTART, CLASS=4, DISP= L 

// JOB NISTART 

x HHH HHH HEH HHH HED DIE HH I 
¥ THIS JOB STARTS NCCF IN F4 % 
He HEHEHE HEHE HEHE DEH HED HHH DH OHO BH HD 9 9 0 9 9 9 0 0 
7/ DLBL DSILOGP, "NCCFPLOG',,VSAM, CAT=SIPOEUC 

// EXTENT. SYS022,SYSNK1 

// DLBL DSILOGS, *NCCFSLOG',,VSAM,CAT=SIPOEUC 

/7 EXTENT SYS023,SYSWK1 

// LIBDEF CL,SEARCH=CUSRCL1,PRDCLG,PRDCLC),FROM=USRCLI 

//7 LIBDEF SL,SEARCH=CUSRSL1,PRDSLG,PRDSLC), TEMP 

// EXEC DSIDPR,SIZE=AUTO 

/* 

7% 

* $$ EOJ 


Note: 

The DLBL ‘file names’ Cin this case DSILOGP and DSILOGS) have to be con- 
sistent with those in the DSTINIT definition. The ‘file ids’ (NCCFPLOG 
and NCCFSLOG) have to be consistent with the VSAM Cluster name. 


12.1.3 NCCF Definitions 


Defining the NCCF Domain 


NCCF allows you to have multiple network operators. These operators may be 
stationed at various locations in your network. Therefore, you need to 
specify the terminals to which your NCCF operators will log on. To define 
the NCCF terminals the POS or POSPOOL statements are used. 
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The POS statement defines these terminals by name, while the POSPOOL 
statement allows an operator to log on to a certain number of devices that 
have not been previously defined to NCCF. Coding one of these statements 
is required; both may be specified. 


Pick up the SAMPLIB member DSIDMN from the ADMINISTRATOR Lib and modify 
according to your naming conventions. Use POSPOOL statements to replace or 
enhance the POS statements. In these samples the NCCF and the multi-system 
environment naming conventions are used. 


Statements such as POS, POSPOOL, CDMNSESS and MAXSPAN allocates storage 
for these functions so they should not be used indiscriminately. 


4/7 JOB NIDMNCT CATAL DSIDMN 

4/7 LIBDEF SL,TO=USRSLI 

/7 EXEC MAINT 

* CATALS B.DSIDMN 

BKEND 

HE HE HE HE DE IH HEE HK EE DK DK DE DK HE DK HE 3 IK DE DIE 3 DIE 3 DE IE DE DK DE DE DK DE 3 DK DE DE DK DE DK HE DK DE DE DE HE DE DK DE DE DK DK HE DE DK DE DK DK DK 3 WK DE I EK IK 

iS DEFINES THE NCCF ENVIRONMENT x 

HEHE HE HE HK HE DK HEE IE DE DK HE DE DK DEC DE DE DK EDK HE DE DK DE DE DK HE DC DK DE DE IE 3 3K DK 3 DK DE DK DE DE DE DE DE DK DE DE DE DE DE DK 3 DE IKE DE DK IE DE DK IE DEK KE 
NCCFID DOMAINID=A60N1,DMNPSW=PDM60N1 4° 
OPTIONS VERIFY=NORMAL 


POS T60010,T60011 41 
POS T60012,T600301 
POSPOOL 2 : 
CDMNSESS 2 42 
MAXSPAN 6 43 
MAXABEND 2 
MAXLOGON 3 | | 
NINPDA TASK MOD=DSIZDST, TSKID=BNHDSERV, INIT=Y,PRI=1,MEM=NINPDA ‘4 
N1LOG TASK MOD=DSIZDST, TSKID=DSILOG,PRI=1,MEM=N1L0G, INIT=Y 
ACCESS METHOD=V,LEVEL=2 
END 
BKEND 
ie 
/% 


Defining the NCCF Data Services Task 


Pick up the SAMPLIB member LOGREF, which defines the data services task of 
NCCF. 


40 The DOMAINID parameter must match your ACF/VTAM application minor 
node name for the NCCF main task. The DMNPSW must match the PRTICT name 
in the NCCF application definition CAPPL) statements. 

41 The POS parameter must match your ACF/VTAM LU names. 

42 This will allow 2 stations in other domains to log on. 

$3 This NCCF program can handle 6 SPANS of control. 

44 These TASK statements are required for NPDA. 
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7/7 JOB LOGREF 
4/7 LIBDEF SL,TO=USRSLI 
4/7 EXEC MAINT 

CATALS B.NILOG 


CATAL LOGREF 


BKEND 
HEHE HE HE DE DE HEE DE DE HK HE HE DE DK HE DE DK EDK IE HE DE DE HE DE DE HE HE DE DK IEE DE DK IE DED HEC IE IEE DE HK HE DE IE HE IE DE DE DEE HE HE HEE HEE HEHEHE 
* INITIALIZATION PARAMETERS FOR THE DATA SERVICES TASK OF NCCF % 


HE HE 3 HIE HE DE DK DEE DE DK EE DE DE IE DE KE DE DK EDK DE DE DE DE DK DE DE DE DEE DE HE DE DDE DEK HE DE DK IE 3E DE DK DE DE DE DK DK HE DE DK DE DE DE DE IE DE DE IE DE IE IK DE 
DSTINIT PDDNM=DSILOGP,SDDNM=DSILOGS, DSRBO=1,XITVN=DSIWLMED, FUNCT=VSA 
BKEND : 
7% 
7% 


Notes 
The B.book name must agree with the label given to the TASK definition 
statement for DSILOG (see DSIDMN). | 


Defining the Commands and Command Lists to NCCF 


You need to define commands or verbs which NCCF can process. Pick up job 
DSICMD, and modify as follows: 


7/ SOB NICMDCT CATAL DSICMD 
// LIBDEF SL,TO=USRSL1I 
// EXEC MAINT 

CATALS B.DSICMD 


BKEND | 
He HEHEHE HEE HE HE DHE DK DK DE DE DE HED DK DE HK DK DE HE BE 3 DE DE DE DE DK DE OE DDE DD ODD DE OK DDE OK 3 DE 3 3 IO DE IE OD DE EO DE HE OK OK 
% NCCF COMMANDS OR VERBS x 


HE HE HK HE HE IE DEH DE IE DE ESE DE DE DE DE EDK HE DE DE DK DE DE DE DE DE DE IE DE DE DE DE HE DE IE DE HE DE DE DE DE DE HE DE DE DE NK DE DE DE DE DE DE DE DEK DE HE HE DE IE EE HEE 


AGAIN CMDMDL MOD=DSIAGAIN 
AT CMDMDL MOD=DSIATP,TYPE=R 
AUTOWRAP CMDMDL MOD=DSIAWP,TYPE=I 
CANCEL CMDMDL MOD=DSICAP,TYPE=I 
CLEAR CMDMDL MOD=DSICKP,TYPE=I,CTL=S 
ieee etc... ee 
Kg reise Oe @UCs <. ee eee 
ROUTE CMDMDL MOD=DSIRTP 
START CMDMDL MOD=DSISRP 
STOP CMDMDL MOD=DSISTP 
SWITCH CMDMDL MOD=DSISWCP,TYPE=RD,CTL=N 
HE EEK DEE DE IE DE DE DE DE HE HE HE DE DE EK EE HE DEK DE DE DE DE DE DE DE DE DE DE HE HK DE DE DK DEE DE DE DE HE DE DE DE DE DK DE DE DE DE DE DE DE IE 3K DE DK DE DE DE EE EE 
x PF KEY SETTINGS for NCCF COMMANDS x 
HE HEHEHE HE EE EE HE HE DE DE HE IE EE HK EK EK HEE HE HE KEK DE DE EE HEE HE EE HE EE DE DE DE DEK EE DE HE DE DE DK DE DE DE DE DE DE DE DE EK EE EEE 
2 CMDMDL MOD=ICMNCMD, TYPE=R,CTL=S PFK 2 OCCF 
4 CMDMDL MOD=DSICAP,TYPE=I,CTL=S PFK 4 CANCEL 
5 CMDMDL MOD=DSIRSP,TYPE=I,CTL=S PFK 5 RESET IMMEDIATE 
: CMDMDL MOD=BNHPNPDA,CTL=S PFK 10 NPDA 
# CMDMDL MOD=DSIAWP,TYPE=I,CTL=S PFK 11 AUTOWRAP 
a CMDMDL MOD=DSIENP,TYPE=I,CTL=S PFK 12 LOGOFF 
B CMDMDL MOD=ICMNCMD, TYPE=R,CTL=S PFK 14 OCCF 
D CMDMDL MOD=DSICAP,TYPE=I,CTL=S PFK 16 CANCEL 
E CMDMDL MOD=DSIRSP,TYPE=I,CTL=S PFK 17 RESET IMMEDIATE 


188 


Raleigh International Systems Center 


¢ CMDMDL MOD=BNHPNPDA,CTL=S PFK 22 NPDA 
CMDMDL MOD=DSIAWP,TYPE=I,CTL=5 PFK 23 AUTOWRAP 
< CMDMDL MOD=DSTENP,TYPE=I,CTL=S PFK 24 LOGOFF 
HE HE HEHEHE HED HE DE DEDEDE DE HE HE DE HE DE HK HE DE DK DE DE DE HE HC HK CHK HE EE HEE DE HE DE HE HE DHE DEK HE IE HK 3 DE DK DE 3 DK DE DE DE OED DK DE DEK KE 
as CLEAR KEY, ENTER KEY and PAl, PA2 SETTINGS % 
HE HE HEHEHE HEE DE HEH HEHEHE HEHEHE HE HE HE HE DE DE HEHE IE DE HK EK HE DEK HE DE HE EK HE HE IE DE HK HE DE IE DE DE DE ED IE DE 3 HE DEK IE IE EE 
CMDMDL MOD=DSICKP,TYPE=I,CTL=S CLEAR CLEAR 


: CMDMDL MOD=DSINDP,TYPE=I,CTL=5 PA1l ENTER 

% CMDMDL $MOD=DSIAGAIN,TYPE=I,CTL=S PA2 AGAIN 

HE HEHEHE HEHE HEH HEHEHE HE HK HEHE HEHE HK HK DE HEE DK DE DE DE DE DK HEE DE DK IKE DE HE DK HE DE DE HE HK HE HE DE DE HE OE DEK HK HE HEE KEE 
is ACF/VTAM COMMANDS % 
HE HE HEHEHE HH HEHEHE DK HE EE HE EEE HEE HE HEH HE HE HE I HEE DE HIE HE DHE HE DE DE HE HE DE DE DE DK IE HE DEO DK WE DE DE DE OK EK CHEEK 
D CMDMDL MOD=DSIVTP 

DISPLAY CMDMDL MOD=DSIVTP 

F CMDMDL MOD=DSIVTP 

MODIFY  CMDMDL MOD=DSIVTP 


V CMDMDL MOD=DSIVTP 
VARY CMDMDL MOD=DSIVTP 
R CMDMDL MOD=DSIREP 


REPLY CMDMDL MOD=DSIREP | 
HE HEE EH HH HEHE HK HEHE HK HEHEHE DEDEDE DE HEE HK HK HE HE HE HEE HE EH HEHE DK DE HEE HEHE HH IE DE DK HE EH DH DE DEK DED HE DE DEK IE DEE DK 


x NPDA COMMANDS, VERBS PFK10 HAS BEEN SET FOR NPDA x 
HE HEHEHE IE HE HEHE IEE IE IE HEE IE DE DE DE HEHE IE IE DE HE IEE HE HEHE HH HE DEKE DE HEE HE HEHE IEE DEI DE DE DE IC DEE IE DEE DEE I DE IC DEE EE EEE HEE 
NPDA CMDMDL MOD=BNHPNPDA, TYPE=R NPDA PSCP 
BNHIBMPD CMDMDL MOD=BNHPNPDA, TYPE=R NPDA PSCP 
BNHUNSOL CMDMDL MOD=BNHDNPDA, TYPE=RD UNSOL DPCP NAME 
REQMS ~CMDMDL MOD=BNHQNPDA, TYPE=R PSCP CFOR SOLICITATION) 
BNHIBMRQ CMDMDL MOD=BNHQNPDA, TYPE=R PSCP CFOR SOLICITATION) 
HHH HEHE HK HEHEHE IEE HEHEHE HEHEHE IE HEHE HEE HEHE HEH KE HEHE KE HE HEHE IK HE HEE HE HEH HE DE HE IK DE EK HEE HEE DE IK HK DE DE HE HE HEE EH EEK 
x OCCF COMMANDS ¥ 
HEHE HEHEHE HE HEHEHE IE HEHE BEE DEE EE HE DE DE DE DE HEHE DE BEE HE DE DE HE HK DE HEE DK DE DE HK DK DE DE DE DE DE DE DE DE DE DK DE DE DE DE HE HK DK DEK DE DEE EEK 
OCCF CMDMDL MOD=ICMNCMD | 
0 CMDMDL MOD=ICMNCMD 

BKEND 
SK 
1% 
Note: 


This book contains ACF/VTAM and NCCF, as well as NPDA and OCCF commands. 


Defining NCCF Operators 


You should modify the SAMPLIB job DSIOPF according to your naming conven- 
tion. . 


Include as many operators as you may need. 


4/7 JOB NIOPFCT CATAL DSIOPF 
// LIBDEF SL,TO=USRSL1I 
47 EXEC MAINT 
CATALS B.DSIOPF 
BKEND , 
ptttttiettesetttttsrretititetttttestttiterestt irri et ttt eter tse sere pbs: 
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x DSIOPF DEFINES NCCF OPERATORS AND THEIR PASSWORDS. 
HEHE 3 HE HE IE HE HE DE DK DE IE IE DE IE DE IE DE DE IE IE IE DE DE DE IC DEK BEDE DE DE DEDEDE IE DE ENE DE DK DEE DE DE DE DCE DE DE DE DE HE DE DE DEE IE DE DE DE DE DE IE DE DE 3G 
OP601N1 OPERATOR PASSNORD=POP601N1 
| PROFILEN PROFSYS 7 

OP602N1 OPERATOR PASSWORD=POP602N1 

| PROFILEN PROFSYS 

END 

BKEND 
7% 
/% 


Defining Operator Profiles 


The job PROFSYS from ICCF SAMPLIB (lib. 59) is a sample of how to define 
characteristics of various NCCF operators by defining their profiles. 


77 JOB PROFSCT CATAL PROFSYS 
4/7 LIBDEF SL,TO=USRSL1I 
/¢7 EXEC MAINT 
CATALS B.PROFSYS 
BKEND | 
HE HE DE HE DE DED 3€ DE DE DE DE DEK HE DK DE DK 3 HE DE DE DED DE DK DE DE DE DE DE HE DE DE DE DE HE DK DE DEE BK DE IE DE DE IK 3€ DE DC DE DK DE DE DE DK DE HE OK 3 DE DE DK 3 DE DE DE IE IE 
x PROFSYS DEFINES NCCF OPERATOR PROFILE NAMED PROFSYS 
PEE PSS LESESSESES SS ESE SEE SES ESS ESSELTE SS SESS S SPSS SESS SSE SE SSS SES ES EET ES SS 
PROFSYS PROFILE 
AUTH CTL=GLOBAL,MSGRECVR=YES 
END ) 
BKEND 
/* 
7% 


The following sections show how to create optional CLISTS and user exits 
to improve the usability of NCCF. | 


Defining an NCCF Command List 

A command list can be written to : 

@ simplify the issuing of a command or series of commands to the system; 
for example, deactivating a set of ICA definitions and reactivating 
another set. 

° provide additional function or to give more information to the opera- 
tor, such as a 'HELP' function. A CLIST can be provided to display 
available CLISTS on the system. 


e automatically provide a response to an ACF/VTAM message, or to auto- 
matically clarify the message before it is displayed. 


When creating a CLIST, make the first statement: 


<label> CLIST 
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This will define the CLIST to NCCF. If you want to use SCOPE*%® checking, 
you need to add a CMDMDL statement to the DSICMD for each CLIST as 
follows: 


clistname CMDMDL MOD=DSICCP 


Here is an example of a CLIST used to simplify the VARY ACTIVATE command. 
It allows you to enter: 


ACT nodename <scope> instead of 
V NET,ACT,ID=nodename<, SCOPE=scope> 


7/7 JOB CATCLIST 
4/7 LIBDEF SL,TO=USRSL1 
// EXEC MAINT 
CATALS B.ACT 
CLIST 
&CONTROL ERR 
* VARY NET,ACT,ID=nodename, SCOPE=(COMP,ONLY,ALL,U) 
SIF .&1 EQ . &THEN &GOTO -TELL1 
&A = &1 


~TELL4 
&SCOPE = &B 
&IF .&SCOPE EQ . &THEN &SCOPE = U 
&IF &SCOPE EQ A &THEN &SCOPE = ALL 
&IF &SCOPE EQ ALL &THEN &GOTO -GO 
&IF &SCOPE EQ C &THEN &SCOPE = COMP 
&IF &SCOPE EQ COMP &THEN &GOTO -GO 
&IF &SCOPE EQ 0 &THEN &SCOPE = ONLY 
&IF &SCOPE EQ ONLY &THEN &GOTO -GO 
-GO 
&WRITE VARY NET,ACT, ID=&A, SCOPE=&SCOPE 
VARY NET,ACT,ID=&A,SCOPE=&S5COPE 
&EXIT 
“TELLS 
&WRITE * INPUT REQUIRED, RE-ENTER. 
&EXIT 
BKEND 
7% 
7 & 


Further examples, details and hints on writing CLISTs can be found in the 
manual NCCF Customization. 


45 When you define NCCF operators and commands, you can limit the use of 
commands to an operator or group of operators. For example, you may 
want to restrict the use of the CLOSE or STOP FORCE commands to a sub- 
set of NCCF operators. See the NCCF Installation manual for details. | 
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Creating an NCCF Exit 


The NCCF macros are held in production service library 'G"', so this will 
need to be restored before creating any NCCF exits. 


To enable you to use PF keys to initiate CLISTS as well as commands, it 
Will be necessary for you to provide code for user exit DSIEX01. This 
must be included in the NCCF library during installation. The following 
is an example of an NCCF exit DSIEX014® ; 


// JOB NCCFEX1 
7/7 LIBDEF SL,SEARCH=CUSRSL1,PRDSLG,PRDSLC), TEMP 
f/f OPTION CATAL 
PHASE DSIEX01,* 

// EXEC ASSEMBLY 

Ets eettt tise ttettttrti pst ttttet irre es: 

NCCF USER EXIT DSIEX01 x 

HEHEHE HEHEHE HE HEE DEI HEE IE DE DE DK DE DE DE DE IK HE HE DE DE DE DE DK IE DE DE DE DE IK 3K 3 DEDEDE DE 

This exit intercepts input from an NCCF screen 


x 
* 
% 
x% 
% 
*% PURPOSE 

% KKK KRKX . 

% The purpose of this exit is to change the command verb 
x that is submitted when a program function key is used 

¥ from an operator terminal. This enables PF keys to be 

% used to submit command lists. Some keys are not changed, 
x so that they may be used to submit immediate commands. 

% ? 

¥* 

x 

% 

% 

% 

x 

x 

¥% 

% 


METHOD 

HHH HX 
The command verb begins with a percent sign (%) followed 
by a character identifying the key (AID). The hex value of 
the identifying character is used to look up a value ina 
translate table. If the table value is zero, no action is 
taken; if non-zero then the character identifying the PF 
key is replaced by the value found in the table and the '%? 
is changed to "$"', 


| EJECT 
x 
3 
x | 
* INPUT 
% XXX 
* (NOTE: % = HEX '6C") 
* PFKEY Input Hex PFKEY Input Hex 
Kt ere ne te se tae eo meee a tae ee a 
x 1 “41 =66CFI1 13 %A 6 
x 2 42 8 6CF2 14 %B 806 CC 2 
x 3 *3  =6CF3 15 4G = CCS 


46 Please note that this code has not been subjected to any test and may 
not work. 
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¥ 4 %4 6CF4 16 %D 6CC4 
x 5 %5 6CF5 17 ZE 6ccs5 
% 6 %6 6CF6 18 %F 6CC6 
x 7 ra | 6CF? 19 %G 6CC7 
x 8 %8 6CF8 20 ZH Ss C6 CCB 
X 9 *9 6CF9 21 %1 6CC9 
% 10 %3 6C7A 3 22 %° 6C4A 
% 11 “~F 6C7B 23 hs 6C4B 
% 12 ar) 6c7c 24 *< 6C4C 
¥ 

¥ CLEAR 4 6C6D PA1 hh 6C6C 
% PA2 %> 6C6E 
S ENTER %* 6c7c PA3 % » 6C6B 
% 

* QUTPUT 

KH KHKKHKKH 

x PFKEY NO, VALUE PFKEY NO. VALUE 

x tan sens eee eens we ween wee me ee me tet em es, mn cm ees Ce OD nD ee sans Om we 

¥ 1 $1 13 $D 

* 3 $3 15 SF 

* 8 $8 20 SH 

* 9 $9 21 $I 

* ALL OTHER KEYS ARE UNCHANGED. 

% 

% If you want to change a PF key to specify a command instead of a 
¥ CLIST or vice-versa, you will need to update the translate table 
¥ at the end of the routine. 

x 

* REGISTERS USED 

HHI IH HEH IH K HE | 

% R1,R2 USED BY TRT INSTRUCTION 

% R3 ADDRESS OF 1ST ENTRY IN PARSE TABLE 

54 R4 ADDRESS OF PDB 

% R5 ADDRESS OF COMMAND VERB IN BUFFER 

% 


HEHE HK HE HE IE HK HE HE HE HE HE DE EE EE HE DE EK HE EEK HE EK EE EK HEH KKH KKK MK KK HN 


% ADDRESS PDB & DATA IN INPUT BUFFER as 

HE HK HE HK HK HE EK HEH HK HK HK HE EE HK EEE EK HK HE IE DE HE DE EE HE KE EOE EK EE DE EEK 
EJECT 

DSIEX01 CSECT 
DSICBS DSITIB,DSIPDB, DSISWB, DSIUSE, DSIMVT,DSISVL,DSITVB % 

DEFER=ALL INCLUDE CONTROL BLOCKS AT END 

STM 14,12,12013) SAVE REGISTERS 
LR 10,15 SET BASE ADDRESS 
USING DSIEX01,10 
LR 7,1 MOVE USER EXIT P. LIST ADDR 
USING DSIUSE,? 
b -11,USERSWB LOAD SWB REG WITH SWB ADDR 
USING DSISWB,11 


LA 2,SWBSAVEA GET ADDR OF SAVEAREA 
ST 2,8(13) . 

ST 13,4%C2) 

L 4,USERPDB PDB ADDRESS IN R4% 
USING DSIPDB,4 ADDRESS PDB 


Chapter i2: CNM Customization 193 


Raleigh International Systems Center 


CLI PDBNOENT+1,X‘'00° DATA IN INPUT BUFFER 

BE RETURN IF NOT , RETURN , 
LA 3,PDBTABLE | GET PDB ENTRY FOR CMD VERB 
USING PDBENTRY,3 

CLI PDBLENG,X'02'" LENGTH CMD VERB EQ 2 

BNE RETURN IF NOT RETURN 

L 5,PDBBUFA ADDRESS OF CMD BUF 

LH 1,PDBDISP DISPLACEMENT 

LA 5,0(¢1,5) R5 ADDRESS OF CMD VERB 


HE HE DE DE HE IE HE DE DE DE HK DE HE HE DE DE DE HE IE HK HE DE DE DE DE DE HE DE DE DE DE DE DE DE EE EE EEK KKM KKK KNX 


* IF NOT PA, PF, CLEAR OR RETURN KEY, RETURN x 
HE HE 36 HE HEHE DE 3 HE 3 HE DK HE DK HEHE HE 3K 3 DED HE DHE DDE HK HE HEHE EE HK IE HEH KH 


CLI 005),C°%" CHECK IF COMMAND STARTS WITH % 

BNE RETURN | RETURN IF NOT 

TRT 1€1,5),TRTABLE CHECK 2ND BYTE OF COMMAND 

BC 8,RETURN RETURN IF ZEROS 

STC 2,15) OR REPLACE 2ND CHAR 

MVI 0€5),C'$' CHANGE 1ST CHAR TO $ 
RETURN EQU x 

L 13,4013) 

LM 14,12,12(€13) 

SR 15,15 

BR 14 
TRTABLE DC 74X"00' 

DC X'000000' PFKEYS 22-24 

DC 45X'00' 

DC X*000000' PFKEYS 10-12 


DC 68X'00' 
BC X¥"'C400C60000C90000D3' PFKEYS 13-21 
DC 39X00! 
DC X'*FLOOFSOOOOF60000F9" PFKEYS 1-9 
DC 6X"'00' 
END 

7% 

// LIBDEF CL,TO=USRCL1, TEMP 

4/7 — EXEC LNKEDT 

7% 

The PF keys will be set up so that depressing PFK 1 will cause the CLIST $1 


to be executed, PFK 3 will cause CLIST $3 to be executed and so on. These 
CLISTS should be coded according to the needs of your installation. 


12.1.4 ACF/VTAM Definitions 


Defining NCCF as an ACF/VTAM Application 
You need to define the NCCF applications to ACF/VTAM. Job NCCFVLST in the 


SAMPLIB is a sample ACF/VTAM definition which you should modify according 
to your naming conventions. 
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You can define a separate major node for NCCF or include the APPL state- 
ments into existing application major nodes. 


// JOB A602CT ACF/VTAM APPL MAJOR NODE 
// LIBDEF SL, TO=USRSL1 
/¢ EXEC MAINT 
CATALS B.A602 
BKEND B.A602 
HH HE HK HEHE HEHE HK HE HE HE KE DEE HE HEE EK HE HE DE HE DE HE DE DE EE HE HK HE HE HEE HE HE HE HE HE IK EE EE HEE EE EE EE HK EE KE EE EE EK EEK HE 
x APPL. MAJOR NODE FOR NCCF 
HE HEHE HEHEHE HEHE DE IE HE HE EE EE HK EK EE HE KE EE HEE HK EE EK EE EK EK EEE EE HE EE EK KE EE EE EEE EEE KKM HK 
A602 | VBUILD TYPE=APPL 
A60N1 APPL AUTH=CACQ,PASS),PRICT=PDM60N1, EAS=6 47 
AG6ONIPPT APPL AUTH=(PPO),PRTCT=PDM60N1,EAS=1 48 
AG60N1000 APPL AUTH=(SP0,ACQ),PRTCT=PDM60N1, EAS=2 49 
AGON1001 APPL AUTH=(SP0,ACQ),PRTCT=PDM60N1,EAS=2 
A60N1002 APPL AUTH=(SPO,ACQ),PRTCT=PDM60N1, EAS=2 
A60N1003 APPL AUTH=(SP0,ACQ),PRTCT=PDM60N1,EAS=2 
AG0N1004¢ APPL AUTH=(SPO,ACQ),PRTCT=PDM60N1,EAS=2 
A60N1005 APPL AUTH=(SP0,ACQ),PRTCT=PDM60N1, EAS=2 
AG60N1006 APPL AUTH=(SP0,ACQ),PRTCT=PDM60N1, EAS=2 


BNHDSERV APPL AUTH=CCNM),EAS=1 29 
BKEND 

7% 

7% 


The EAS values for the NCCF Main Task, the Primary POI Task and NPDA 
application statements should be coded as shown. For the other subtasks, 
the value should equal the number of domains with which the the subtask 
can start a session, plus one for the subtask's terminal. 


The PRTICT names must match that provided in the NCCFID statement in the 
DSIDMN definitions. These are optional, and you may prefer to leave them 
out for the sake of simplicity. If you do leave them out, you should also 
leave out the DMNPSW on the NCCFID statement of the DSIDMN book. 


It may be necessary to increase the MAXAPPL value on the ACF/VTAM startup 
list to accommodate the new applications that have been defined. 


Create the NCCF Terminal Session Parameters 


For each terminal that can be used as an NCCF operator station an entry in 
a LOGMODE table must be exist for that terminal. The entry name must be 
DSILGMOD CLOGMODE=DSILGMOD): this is required by NCCF. 


47 Application statement for the NCCF Main Task. 

48 Application statement for the Primary POI task. 

49 You have to define at least one APPL statement CA60Ninnn) for each 
operator and hardcopy printer. 
You also need one APPL statement for each NCCF - NCCF session ina 
multi-system environment. | 

5° Application statement for NPDA 
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It is recommended that you code three tables, each with a DSILGMOD entry: 
one for LU type 0 (non-SNA 3270s), one for LU type 1 (SNA printers), and 
one for LU type 2 (SNA displays). Details on how to code these tables can 
be found in the saction ‘User Defined ACF/VTAM tables’ in Chapter 6 of 
this document. 


Create the NCCF-NCCF Session Parameters 


If you will be using NCCF-NCCF cross-domain sessions, as distinct from 
simple cross~-domain yereee to NCCF, you will need to: 


1. Create an additional modetable with an entry for the application ze 
application session (NCCF-NCCF), as follows- 


77 JOB MODETAB 
// LIBDEF CL,TO=USRCLI1 
7/ LIBDEF SL,SEARCH=PRDSLG 
// OPTION CATAL 
. PHASE DSIXDOM,* 

7/7 EXEC ASSEMBLY 

DSIXDOM MODETAB 

DSILGMOD MODEENT LOGMODE=DSILGMOD, FMPROF=X'03',TSPROF=X'03', 
PRIPROT=X'20",SECPROT=X'20" ,COMPROT=X'4000', 
RUSIZES=X'0000' ,PSERVIC="000000000000000000000000' 


MODEEND 
END 
7% | 
“7 EXEC LNKEDT 
7% 
7% 


2. Modify the NCCF "APPL" statements for the operator tasks in the appli- 
cation node B.book (A602 in the sample supplied) as follows: 


AGONIO00 APPL AUTH=CSP0,ACQ),PRICT=PDM60N1,EAS=2,MODETAB=DSIXDOM 
i> 2S eoee etC. 


Updating the USS Table 


To enable ease of logon to NCCF you should update the USS Table which is 
used by the terminal(s). The example provided in Chapter 6, section 'User 
Defined ACF/VTAM Tables’, shows a USS table with an entry for logging an 
to NCCF. | 


This entry consists of the following statements, which, if added to your 
existing table will allow you to logon to NCCF by eantering 'NCCF60" from 
the ACF/VTAM logon screen: 


NCCF60 USSCMD CMD=NCCF60,REP=LOGON, FORMAT=BAL 
USSPARM PARM=APPLID, DEFAULT=A60N1°! 
USSPARM PARM=LOGMODE 
USSPARM PARM=DATA 
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If you update a USS table, ACF/VTAM must be restarted before the change 
comes into effect. 


12.1.5 Preparing NCCF 


Creating the NCCF VSAM Space and Log Datasets 


You need to define log files to NCCF. These files are used to record mes- 
sages or commands sent to or from operator terminals. 


Two log files are defined: a primary anda secondary one. 


The SAMPLIB members NCCFVSP and NCCFCLU are samples of how to create VSAM 
space and the log files for NCCF. 


Note: 

You should refer to the system IPO/E dasd layout charts to choose unused 
space for the log files and evaluate where you want to place the log files 
on one of your disk packs. Modify and rename the jobs in the ADMINISTRATOR 
Lib before you submit them. 


12.1.6 Starting NCCF 


When you run the NCCF start up job stream, you will receive several mes- 
sages. The messages that are normal if you are using the System IPO/E sam- 
ple definitions are: 


DSIO86I NCCF DSISPN NOT FOUND ON DISPARM 
DSIO90I LOAD FAILED FOR NCCF MODULE DSIEXO1 

---etc. for each exit that is not coded 
DSIO090I LOAD FAILED FOR NCCF MODULE DSIEX14 
DS$I112I NCCF READY FOR LOGONS AND SYSTEM OPERATORS COMMANDS 
DSI80Z2A REPLY WITH VALID NCCF SYSTEM OPERATOR COMMAND 
DSI530I DSILOG : DST IS READY AND WAITING FOR WORK 


You should ignore messages DSIO86I and DSIO90I. A DSIO90I message will 
occur for each exit that has not been coded. If you want to suppress these 
messages, code dummy routines for any unused exits as shown in the NCCE 
Customization manual, section 5-13. 


51 The default must be the name of the NCCF hain task defined in the NCCF 

application major node; AS60N1 shown here is consistent with that used 

in the application major node definition statements provided in this 
chapter. 
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Messages pstiie2z and DSI802A indicate that NCCF is pendy for western opera 
tor commands as wall as ‘terminal epererere: logon commands. 


Message DSI5301 indicates that the NCCE log file is ready to be used. 


12.1.7 Test of Your Customized NCCF Definitions 


Testing of the installed NCCF system should consist of logging on to NCCF, 
testing out the use of ACF/VTAM commands end displays and NCCF CLISTs and 
logging off. 


Logon 


After starting up NCCF from the system console, log on to NCCF from a des~ 


ignated NCCF console by Using the appropriate USS command. If you have 


used the USS table provided in this document, it will be "NCCF60". 
You will then be presented with the NCCF logon screen. Enter the operator 


id and password in the identified fields and press enter. You should now 
havea signed on to NCCF. 


Operation 

To permit automatic scrolling, enter "AUTOWRAP'. Display various nodes in 
the network through the ACF/VTAM DISPLAY command and check that results 
are similar to those produced by executing the same commands from the sys~ 
team console Cunless, of course, you have used the various NCCF facilities 
to change the messages). 

Now check any CLISTS that you may have included. 

Cross-Domain Sassions 

If you have another NCCF program running in a differant domain and both 
the NCCF programs are set up to aestablish NCCF-NCCF sessions, you can test 
the facility at this point. This is done by the use of the NCCF "START* 
command: 

START DOMAIN=domainid 


. where domainid is the name of the other NCCF domain. 


The cross-domain session can then be tested as for the primary domain, 
using the NCCF command: 


ROUTE domainid, command 
The command: 


STOP DOMAIN=domainid tarminates the session. 
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Logoff 
To logoff from NCCF simply enter LOGOFF from the NCCF console. 
Terminal Access Facility 
If this feature is included in your system, test it by logging on to CICS 
Cor another ACF/VTAM application program) by using the NCCF 'BGNSESS' com- 
mand, the syntax of which can be found in the NCCF Terminal Use manual. 
ENDSESS should be used to terminate the session. 
To sign off from NCCF simply enter "LOGOFF’. 
NCCF Shutdown 
To shutdown NCCF, enter: 
MSG nn 
.. Where nn is the number of the NCCF partition. 
When you receive a reply from VSE, enter: 


n CLOSE 


-- and NCCF will be shut down. 


oy 
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12.2 OPERATOR COMMUNICATION CONTROL FACILITY (OCCF) 


The SIPO/E 3.1 contains VSE/OCCF Release 1 (5746-XC5). 


The function of VSE/0CCF is to suppress messages, translate messages, 
automatically reply to messages or route messages to an NCCF console. 


While NCCF works on ACF/VTAM messages only, OCCF can be used to. handle all 
messages destined for the system console. OCCF can be used directly from 
the system console, from NCCF running on the same processor, or froma 
remote site. In this way, it is possible to control one or more remote VSE 
systems from a central site. This can be done in one of three ways. 


1. Through an ACF/VTAM cross-domain logon to a remote NCCF application 
where its host also has OCCF. See Figure 37. This can be achieved from 


a host that does not have NCCF. 


DOMAINS DOMATINI 


Operator logs on to 
NCCF in DOMAINS 


Figure 37. Cross Domain Logon to Remote NCCF 


2. By the central NCCF application establishing a cross-domain NCCF-NCCF 
session with the remote site. A central NCCF operator can then receive 
and send messages to and from the remote NCCF, which in turn passes 
the these messages to and from OCCF on the same host. This requires 
that NCCF be implemented in both domains; it allows multiple remote 
sites to be controlled from one screen ata central site, without the 
necessity of the operator constantly logging on and off from the 
sites. See Figure 38. 


DOMAINS DOMAIN] 


Established NCCF-NCCF 
Session | 
NCCF operator in. 
DOMAIN1I uses the 
NCCF-NCCF session 


Figure 38. Use of the NCCF-NCCF Session 
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3. By using the NCCF feature TAF to allow an NCCF operator in the central 
site to log on to the remote NCCF. Again NCCF needs to be implemented 
in both sites, with TAF in the central site. This also allows multi- 
ple remote sites to be controlled from one screen at a central site, 
without the necessity of the operator constantly logging on and off 
from the sites. In addition, the screen can be used concurrently 
access other ACF/VTAM applications such as CICS/VS and TS0. See 
Figure 39. 

DOMAINS DOMAINI 


Logon to NCCF in 
DOMAINS 


NCCF operator in 
DOMAINI logs on 

to DOMAINS NCCF 

through TAF 


Figure 39. Use of TAF to log on to a Remote NCCF 


OCCF allows you to tailor your OCCF system so that each message can be 
acted upon according to the needs of your installation. 


With this in mind evaluate your installation message traffic and determine 
the action VSE/OCCF should take on each message or group of messages. 


OCCF Verification 


To verify the installation of VSE/OCCF, the IPF Verification Dialog cre- 
ates a job stream, which will generate a VSE/OCCF action table, a message 
translation table, a VSE/OCCF start-up job stream, and a job stream to 
test the generated VSE/OCCF functions. 


In the SERVICE.SYSSLB.A are three sample VSE/OCCF generation decks. They 
are catalogued in the A.sublib as OCCFS1, OCCFS2 and OCCFS3. Any of these 
may be modified to route messages to the NCCF operator to allow you to 
verify the installation of VSE/OCCF and NCCF. 


Note: 


Refer to VSE System IPO/E User's Guide Release 3.1 page 43 for more infor- 
mation. 


12.2.1 JCL Startup Statements 


VSE/OCCF with NCCF must run ina partition of higher priority than any for 
which it will handle messages. However, ACF/VTAM must be in a higher pri- 
ority partition than VSE/OCCF: 
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e.g. PRTY FB,FA,F9,F8,F7,F6,F5,BG,F2,F1,F4,F3 


F3 = ACF/VTAM 

F4 = VSE/OCCF AND NCCF 
Fl = VSE/POWER 

F2 = CICS/VS 


12.2.2 The OCCF/NCCF Start Job 


The following job stream will start up VSE/OCCF and NCCF in F4 controlled 
oy VSE/POWER: 


x $$ JOB JNM=NLOCCFST,CLASS=4,DISP= L 

77 JOB NIOCCFST 

HEHE HEHE EEE DE DEE IE DE DE HE DE DE DE IE DE DE HE DK HEE DE HE DE HK IE DED IEE KE EEE MMM MMM MMM KKK MK KKK KKK 
ss THIS JOB STARTS UP VSE/OCCF WITH NCCF IN F4 * 
% DE HE HEHEHE HEHEHE EDI HC 3K 3 HEHEHE HD HD HD 9 WD HH I 0 
7/7 DLBL DSILOGP, 'NCCFPLOG',,VSAM 


x NCCF PRIMARY LOG 
77 DLBL DSILOGS, "NCCFSLOG',,VSAM 
x NCCF SECONDARY LOG 


// LIBDEF CL,SEARCH=CUSRCL1,PRDCLG,PRDCLC),FROM=USRCL1 
//7 LIBDEF SL,SEARCH=CUSRSL1,PRDSLC),TEMP 

// LIBDEF RL,SEARCH=PRDRLC, TEMP 

// EXEC OCCF3,SIZE=512K 54 

7¥ 

7& 

* $$ EOJ - 


With this jobstream, the OCCF program is started and NCCF is run as a sub- 
task in the same partition, F4. 


12.2.3 OCCF Definitions 


A sample of a MESSAGE ACTION TABLE jis provided in SERVICE.SYSSLB.A 
COCCFS3). This is the primary VSE/OCCF control table in which messages are 
designated for routing, automatic reply, suppression, or messages trans- 
lation. This sample contains entries that route all messages related to 
operator actions to the system console and all others messages to the 
default target. 


52 OQCCF3 is the phasename for the Message Action Table and must be used 
in the EXEC statement of the VSE/OCCF start job. 
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VSE/OCCF Macros 


OCCF macros are used for specifying the OCCF options and for defining con- 
trol tables to tailor the OCCF environment. 


€ The OCFOPT macro 


This is used to specify various OCCF functions, such as if the alarm 
is to be sounded upon receipt of each message and if NCCF is to be 
started along with OCCF. The macro supplied in the example is: 


OCFOPT PHASE=0CCF3,NCCF=YES,ALARM=YES 
The PHASE name is the name specified in the startup JCL. 
e The OCFMAR macro 


This specifies the entries for an MATAB. It identifies the messages 
for which action will be taken and what type of action, such as rout-— 
ing and automatic reply. If message translation is done, the macro: 


OCFMAR  TYPE=TRANSL 


must be the first OCFOPT macro in the table. Macros identifying mes- 
sages to be translated immediately follow this macro. The verifica- 
tion sample supplied provides the macro: 


OCFMAR MID=11I00D, TRANSL=MSGLI 
where MID is the number of the message to be translated and MSGILI 
points to the table with the message translation, which has the phase 
name 'MSGII'. 
If message routing 1s used, the macro: 
OCFMAR TYPE=ROUTE 
must be the first OCFMAR macro in the table, if message translation is 
not used. The message routing macros follow this macro. The MATAB pro 
vided with the SIPO COCCF3) contains the following macro: : 
OCFMAR MID=1Q55D,ROUTE=SYSCONS 
which will route message number 1@55D to the system console. Messages 
can also be grouped together, so that it is not necessary to specify a 
macro for each individual macro. OCCF3 also contains a macro: 
OCFMAR MID=8V96D,REPLY=YES 
which is an example of how automatic replies can be issued. In this 


case, the message 8V96D will automatically cause the generation of the 
reply defined in the OCFTEXT macro with the label 'YES' (€sea below). 
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e The OCFMSGTE macro 


This macro is used to define a message translation. The one indicated 
above and provided in the SIPO verification sample jis: 


OCFMSGTE MID=11I00D,TEXT="READY FOR COMMUNICATIONS 
SYSTEM IST EINGABEBEREIT’ 
OCFMSGTE END 


This table is lLink-edited and the phase name is used in the OCFMAR 
macro. The text can also be given in an OCFTEXT macro. 


e The OCFREPTR macro 


This macro is used to translate a message from the operator into a 
message which can be used by the system. For example the macro: 


OCFREPTR TEXTI=ENTFERNE, TEXT2=DELETE 


will translate an operator's reply of 'ENTFERNE' to 'DELETE' for use 
by the system. 


e The OCFTEXT macro 
This can be used to provide text to an OCFMAR or an OCFMSGTE macro. 


More complete information on the use of all these macros can be found in 
the manual VSE/OCCF Installation Guide and Reference. 


Defining VSE/OCCF to NCCF 


The VSE/OCCF command processor ICMNCMD must be defined to NCCF during NCCF 
generation with the NCCF '*CMDMDL* macro: 


commandname CMDMDL MOD=ICMNCMD 


.. where commandname 1s the command to execute OCCF, usually simply '‘OCCF'® 
or 'O'. This is how it is specified in the NCCF DSICMD book in the earlier 
part of this chapter. 


Operation with VSE/OCCE 


Operating through OCCF from a system console is straightforward. Console 
commands are intercepted and processed by OCCF. This facility is useful if 
you want to simplify and streamline the operation of a VSE system. 


Operation using OCCF can also be done from an NCCF operator's screen on 
the same host. This is done by establishing a link with OCCF through the 
use of the Q@LOGON command as described later in this chapter. Messages to 
OCCF from the NCCF screen are prefixed by the OCCF keyword which is usual- 
ly '"OCCF® or 'O*. The NCCF operator's screen may be local, remote, or 
cross-domain. 
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Starting OCCF from an NCCF Console 
Once OCCF and NCCF have been started by the jobstream, a data link between 
programs can be established by issuing a 'QLOGON' command from an NCCF 


console. Only one NCCF console can receive messages from OCCF at a time. 


The method for using the QLOGON command depends on how your system is set 
uP. 


1. If you are using a local OCCF from a local NCCF the following applies: 
a. logon to the local NCCF 


b. anter the OCCF keyword followed by QLOGON to allow routing of maes- 
sages to your station. 


2. If you are accessing a remote OCCF: 


e by an ACF/VTAM cross-domain logon, that is, not through a central 
NCCF system 


e from a central NCCF system using TAF 
the following applies: 


a. logon to the remote NCCF by cross-domain logon or trough TAF from 
the local NCCF 


b. anter the OCCF keyword followed by QLOGON to allow routing of mes-— 
sages to your station. 


3. If you are using the NCCF-NCCF session to access a remote OCCF the 
following applies: 


a. logon to central NCCF 


b. establish the cross-domain session to the remote system using the 
"START command of NCCF Ci.e. START DOMAIN=domainid) 


c. use the "ROUTES of NCCF to issue the QLOGON to allow routing of 
messages to your station 


Ci.a@. ROUTE domainid keyword QLOGON). 


VSE/OCCE Commands 


The VSE/OCCF commands are summarized below in Figure 40 on page 206. 
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Establishes data-link between the NCCF 
console and the VSE/OCCF program 
Terminates the data link established 
by QLOGON | 


~ QLOGON 


QLOGOFF. 


Suspends VSE/OCCF functions 
Reinstates suspended VSE/OCCF functions 
Terminates VSE/OCCF processing 


QSTOP 
QSTART 
QEND 


Displays messages from hardcopy file at the 


NCCF- the most recent message routed to the 
NCCF operator station | 
NEXT- the next 'older't message after ALL 
or NCCF option used 
END- end the display 


Figure 40. VSE/OCCF Commands 


Terminating VSE/OCCF 


COMMAND ACTION _* | 


To terminate OCCF processing the command QEND is used. If NCCF is running 


in the OCCF partition, it remains active, otherwise the partition 


freed. 
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12.3 NETWORK PROBLEM DETERMINATION APPLICATION (NPDA) 


The SIPO 3.1 contains NPDA Release 2.1 (€5735-XX8). 


NPDA is a product which collects and processes hardware errors associated 
with various IBM devices in your communications network. Error data are 
collected on IBM 4331 under VSE for SNA and BSC/SDLC devices only. Error 
data on local devices are not processed by NPDA under VSE. 


NPDA is run as a command processor under NCCF, so NCCF needs to be 
installed first. You will need to complete several steps to define NPDA to 
NCCF and ACF/VTAM. 


The following sections describe the customization of jobs from the SIPO/E 
3.1 SAMPLIB. You should review these job streams to determine if they are 
applicable to your system. The NPDA Installation manual should be used as 
a reference. After any necessary modifications have been made, run the 
jobs to catalog the definitions in USRSLI/USRCLI. 


12.3.1 NPDA Definitions 


The NCCF startup JCL supplied in the first section of this chapter 
includes NPDA, as does the JCL supplied in the section on OCCF. 


You must catalog a B.book in the USRSL1 to define NPDA. 


The name of this book is B.NINPDA, and it is used partly to define NPDA to 
NCCF, and partly to specify parameters for the NPDA data bases and exit 
routines. 


SAMPLIB member NPDABNH is an example of how to define and catalog the NPDA 
definitions. The NPDA Installation manual, page 27 will direct you if you 
want to change any of the default values specified in this job. 


/7 JOB NINPDA CATAL NPDA DEFINITONS 
// LIBDEF SL,TO=USRSL1 
// EXEC MAINT 
CATALS B.NINPDA 
BKEND B.NINPDA 
HH HEH HEHEHE HE HE CHE HE DE HEHEHE HE HE HE DEE HEHE DE HK DC IKE DE DE DED HE DE HK HE DE HE DEK IE I HE DE DK DE DE HE HE DE DE DE DK DE DE DK IKE DE DK WE IE IE 
* NPDA DEFINITIONS 
HE HE HEH HE HE HEHEHE HE HEHE HEHE DE DE HE HEHEHE HEHEHE DE HE EH EH EDK HE DE DK HEH DK HE DE DK DK HE DE ED OKC DK HE DEK EEK HEH HK HK HK 
DSTINIT PDDNM=BNHLGPR 
DSTINIT PPASS=USERPASS 5% 
DSTINIT SDDNM=BNHLGSE 
DSTINIT SPASS=USERPASS °4 
DSTINIT DSRBU=1 
DSTINIT DSRBO=10 a 
DSTINIT UNSOL=BNHUNSOL 
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DSTINIT FUNCT=BOTH 
DSTINIT XITVN=BNHAINTA 
DSTINIT XITDI=BNHAPAMA 


LINE 100 | 
NCP 10 56 
CTRL 150 
SNAO1 2 
SNAO2 50 
SNA04 2. 
SNAO5 2 
BKEND 
7% | 
7 & 


The last seven statements shown (LINE through SNA05) are default wrap 
count parameters for the NCP data base for line errors, NCP errors, and 
controller errors for SNA and non-SNA controllers. See the NPDA Installa- 
tion manual for details. 


Defining NPDA to NCCE 
You need to define NPDA to NCCF. 


The B.book DSIDMN Csee section NCCF) must contain the following definition 
statement for the NPDA data services task: 


TASK MOD=DSIZDST, TSKID=BNHDSERV, INIT=Y,PRI=1,MEM=NINPDA 


Defining NPDA Commands to NCCE 


You need to define the NPDA commands to NCCF. This has been done in the 
example provided in the section on NCCF in this chapter. The NPDA keyword 
that has been used in the supplied NCCF definitions is "NPDA' which is the 
most common and logical choice. 


12.3.2. ACF/VTAM Definitions 


Defining NPDA as an ACF/VTAM Application 


You have to define NPDA as an ACF/VTAM application. The major node A602 
described in section NCCF contains the application BNHDSERV, which is the 


53> Must correspond to the UPDPW parameter in the primary VSAM data base 


allocation. 
54 Must correspond to the UPDPW parameter in the secondary VSAM data base 
allocation. 
Number of users that can be logged on. 
36 Only if an NCP is used. 


35 
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NPDA application. This is done to identify the NDPA data services task to 
the ACF/VTAM Communications Network Management (CNM) Interface. 


Defining NPDA in the ACF/VTAM CNM Routing Table 


NPDA uses the CNMI (CCommunication Network Management Interface) of 
ACF/VTAM. You have to define the SNA request units CRECMS, RECFMS) which 
ACF/VTAM will pass over the CNMI to NPDA. Member NPDAIST of the SIPO/E 
3.1 SAMPLIB is an example of how to do this. 


// JOB NPDAIST ASS/LINK ISTMGC00 FOR NPDA ENTRIES 
KKH HII HK ICH IE HEH HHH HEH IH HEHEHE HI HEHEHE HE IE HEH HK HEE HEHEHE IEE HE HEHE HH HK HK HK HCE 
% ASSEMBLE AND LINK EDIT ISTMGCO0 % 
ae £22 2 2 2 Pe PS eee ete eet eee ee eet eee ere ere Set eee etree es eters reset e resets. 
// PAUSE | 
4/7 LIBDEF CL,TO=USRCLI 
4/ OPTION CATAL 

PHASE ISTMGCO0,* 
4/7 EXEC ASSEMBLY,SIZE=64K 
ISTMGCO0 CSECT 


DS OF | 
DC X"'0002' NUMBER OF ENTRIES 
DC X'o00Cc" LENGTH OF EACH ENTRY 
DC XL4'00000000' RESERVED 
DC XL4'00000000' RESERVED 
DC XL1'00' FLAGS FOR NPDA A/VTAM R2 CNMI 
DC XL3°010381' RECMS 
DC CL8"*BNHDSERV' MUST APPEAR IN APPL STMT FOR VIM 
DC XL1'00' FLAGS FOR NPDA A/VTAM R2 CNMI 
DC XL3'410384" RECFMS 
DC CL8*BNHDSERV' MUST APPEAR IN APPL STMT FOR VIM 
END ISTMGCO0 
/* 
/7 EXEC LNKEDT 
/% 
/% 
Notes: 


The same table must be used and expanded if you use the DSLU program for 
IBM 3644 devices or IBM 8775 Cwith enhanced/extended features) 


Define NPDA VSAM Space and Clusters 


You need to allocate VSAM space for primary and secondary data bases into 
which NPDA can log network error data. 


The SAMPLIB member NPDAVSP and NPDACLU are examples of how to define the 
NPDA VSAM space and data bases. 


Note: 
You should refer to the system IPO/E dasd layout charts to choose unused 
space for the log files and to the NPDA Installation manual, page 12 for 
an explanation of how to calculate the amount of VSAM space that you will 
need. 
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NPDA Start 
NPDA is initialized when NCCF is started. 


The following JCL can be used to start NCCF with NPDA in F4. 

* $$ JOB JNM=NISTART,CLASS=4,DISP=L 

// JOB NISTART | 

HE HEHE KK EEK EEE EE EE EEK EE EE EE EK EEE KE EEE EK KK EE EEE EE EE EEK KKK KKK KH KK KKK KN 
x THIS JOB STARTS NCCF IN F4 | x 
% HEHE HEHEHE HE HEHEHE HEHE HEHE HEHEHE DE DEDEDE IE HE DE IE BEDE IE IE IE DE IEE BE IE HE DE HE DE DK HE DE IE IE DE IE DE DIE BEDE DE IC I IE BE DE DE DE DK HE DE IE IEE 
7/7 DLBL DSILOGP, 'NCCFPLOG',,VSAM,CAT=SIPOEUC 
//7 EXTENT SYS022,SYSWKI 

/7 DLBL DSILOGS, *NCCFSLOG',,VSAM,CAT=SIPOEUC 

/4/ EXTENT SYS023,SYSWK1 

// DLBL BNHLGPR, *BNHLGPRI',,VSAM,CAT=SIPOEUC 

4/7 EXTENT SYS020,SYSWK1 

// DLBL BNHLGSE, "BNHLGSEC',,VSAM,CAT=SIPOEUC 

4/7 EXTENT SYS021,SYSWKI 

“4/7 LIBDEF CL,SEARCH=CUSRCL1,PRDCLG,PRDCLC),FROM=USRCLI 

// LIBDEF SL,SEARCH=CUSRSL1,PRDSLG,PRDSLC),TEMP 

//7 EXEC DSIDPR,SIZE=AUTO 

7% 

/& 

* $$ EOJ 


12.3.3 Test of Your Customized NPDA Definitions 


Locon to NPDA 


To use NPDA, log on to NCCF and enter the NPDA keyword. If you have used 
the definitions provided in this manual it is "NPDA*; alternatively press 
PFK 1. The first panel of NPDA will be displayed. 


NPDA Operation 


NPDA is driven through a series of panels displaying data collected from 
the various components in the network, starting with a panel showing NCP 
and ICA selection. From here a hierarchical path can be taken through the 
network Brspeey 10g error statistics and panels recommending user actions. 


NPDA has its own commands to allow the user to ‘bypass panels, in addition 
to the selections provided on the panels themselves. The NPDA command 
word will remain in bottom left hand corner while NPDA is in use and this 
must prefix any NPDA command. Other, non-NPDA commands may be issued while 
NPDA is in use by overtyping the NPDA command word with the command and 
pressing enter. This will take the screen out of NPDA mode and put it back 
in NCCF mode. NPDA can be returned to at the same point that it was left by 
entering "NPDA RESUME from NCCF. 
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Exit from NPDA 


The NPDA command ‘'END* causes the screen to exit to NCCF. NPDA however, 
continues to collect error data on the data bases. An alternative to using 
"END' is to simply exit and resume as described above. 


NPDA terminates when NCCF in ended. 


12.3.4 Using OCCF, NCCF and NPDA Together 


The following JCL can be used to start OCCF, NCCF and NPDA in the same VSE 
partition: 

—*% $$ JOB JNM=N1OCCFST,CLASS=4,DISP=L 

// JOB NIOCCFST 

HE HEHEHE HEHE HK HEH HE KK DE EE EE HE HK HE DE HE DE HE DEE HEE EE DE HE DE DE HE EK DE DE IE IK OE HE HEE DK DE DE DE DE DE DK DE DE DE EE EE KE EE EE EEK 

% THIS JOB STARTS UP VSE/OCCF WITH NCCF IN F4 x 

HE HEDGE HE HE DK 3 HE HE DK 3K HE HK OK DK 3 3 IE DK DK 3 DE WK 3 3 HED DD DE DDD HE DE DE DD 3 HE DE DE DE 3 DE OD DE DE DK DDE DE DD 3 DE DD DD DK 3 WE OKO 
// DLBL DSILOGP,"NCCFPLOG',,VSAM 


x NCCF PRIMARY LOG 
47 DLBL DSILOGS, "NCCFSLOG',,VSAM 
x NCCF SECONDARY LOG 


// DLBL BNHLGPR, 'BNHLGPRI*,,VSAM,CAT=STPOEUC 

// EXTENT SYS020,SYSWK1 

// DLBL BNHLGSE, "BNHLGSEC’', , VSAM, CAT=SIPOEUC 

77 EXTENT SYS021,SYSWK1 

7/7 LIBDEF CL,SEARCH=CUSRCL1,PRDCLG,PRDCLC),FROM=USRCL1 
//7 LIBDEF SL,SEARCH=CUSRSL1,PRDSLC), TEMP 

// LIBDEF RL,SEARCH=PRDRLC, TEMP 

// EXEC OCCF3,SIZE=512K 52 


1% 
* $$ EQJ 
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A.0 INSTALLATION EXAMPLES, NULTI-SYSTEM ENVIRONMENT 


Figure 41 shows the hard- and software configuration used for this primer. 
The following definitions examples are based on this configuration. 


MVS | 3031 
ACF/VTAM V2 


3705 


ACF/NCP V2 


° 


SYS5 4331 
DOS/VSE AF 3 


D 
p 


31/SYS6 4331 
DOS/VSE AF 3 
| A 
re arora 
M 
Xx 


L 

0 

0 Cres 1.5 4 CIcs 1.5 
p | 


/ / 


3 
BSC SDLC 


33 
30 


Figure 41. Multi System Configuration 
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Figure 42 shows the explicit routes defined in this environment. To allow 
SA 60 and 61 to communicate with migration nodes CACF/VTAME or ACF/NCP R2) 
ERO was selected as the primary route to all destination subareas. ER1 and 
ER2 were selected as back-up Cor alternate) routes. The back-up routes had 
to be mapped on distinct ERs to avoid a routing conflict in SA 60 and 61. 


Figure 42. Multi System Environment Routing Concept 
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A.1 DEFINITIONS IN SA 60 


HE HE HE HE HE HE HE HEE HE HE DE HE DE DE DE HE DE DE SE SE DE HE DEK DE DE DE DE DE DE DE DE DE DE DE IK DE DE IK DE DE DE DE IE DE DE DE DE DE DE DE HE DE DE IE DE DE DE DE DE DE DE DE DE DE HE EE 


* ACF/VTAM START LIST 00 x 
HE HEH HEHE HEH HE DE HE HE HEHE HE HE HE HE HK HED DE HE DE IK IE HE DE DE HE HE DE HK HE HE HK HE IC DE HE DE DE HK HE HE HE DE HE HE DE DE IK IE DE DK IE DE DE DE DED OK HE EEE 


SSCPID=60,MAXSUBA=127,MAXAPPL=25,HOSTSA=60,PROMPT 


HE HK HEHE IE HK HEHE HE HE HEHE HE HE DE DE HE DE DE DE DK DE DE DE DE DE DE DE HE DE DE DE DE DE DE HK IE DE HK DE DE DE DE DE HE DE DE DEE DE DE DE DE DE DE DE DE HE DE DE DE DE HE DE DE DE DE HE EH 


x ACF/VTAM START LIST 60 as 
HE 3E 3 3 HE DEH HE 3 DE DEE DE DE IE DE I HE DE IE DE DE DE IK DE DE IE HE DE DE DE DE DE DK DE HE DE HK HE DE DE HE DE WE OK DEE DE DK DK HE DE 3 HK HE DE IE DE ED IK IE IE DE KE EE 


SSCPID=60,CONFIG=60 ,MAXSUBA=127 ,MAXAPPL=25,HOSTSA=60, VPBUF=20480 


HEHEHE HE HE DE HEHE HEHE K HEH HE HK HE HE HE HK HE HE HE HE HE HE HE HE DE HE HE DEK DE IE DE DE HE HE DE HE HE HE IE HE HE HE DE HK DE HE HE DE HK HE DE DE HE DE HE HEE EE EE EEE 


* CONFIGURATION LIST 60 x 
HEHEHE HEH DE HE DEE IE DE DEE DE DE HE DE DK DK DE DE DE DE DEN DE DE IE DE DE HE DE DE DE DE NC DE DE DE DE DE HE DE DE DK DE IE HE HE DE DE DE DE DE DK DE DE IE DE DE DE DE DE IE IEE DE DE DE DE 


A601,H60L11,H60121,N601,V601,M601,R60611 


HE HE HE HE HE HEE HE HE DE DE IE DE DE DE DE IK DE DE DK HE DE DE DK DE DE DE DE HC DE DK DE DE DE DE DE DE DE DE DE DE DE DE DE DE DK DE DE DE DE DK DE DE DE DE DE DE DK DE DE DE DE DE DE OK DE DE DE OK 
% APPLICATION MAJORNODE X 
HE HEE IE DEDEDE DHE DE IE IE DE DE DE DE DE IE DE DE HEE DE DK IE DE DE IE HE DE DK DE DE DE DE DE 3 IE IE 3 DK IE DE DK HE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE IK IK 3E DEE 


A6G0CICS1 APPL AUTH=CPASS,ACQ) 


Appendix A: Installation Examples, Multi~System Environment 215 


Raleigh International Systems Center. 


HE HE HE DE DE DE HE HEE HE DEH DE DE HE DE DE DE DE DE DE IE HE IK DE DEE DE HE DE DE DE DE DE DE DE DE HE DE DE DE DE DE HE DE DE DE DE DE HE DE DE IK DE DE NK DE DE DE DE DE DE DEE EEX 


X LOCAL NON-SNA MAJORNODE - DISPLAY PRINTER ADAPTER x 
HEE HE DE DE DE DE DE DE HE DE DE DK DE DE DE DE HE DE DE DK DE IE DE HK DE DK DE DK HE DK HE DE DE DE HE NE DE DE DE DE HE DK HC DHE DK HE DE DE DE DHE KDE HE HEE HEE IEE HEH DEE 


H60L11  LBUILD 


T60009 LOCAL CUADDR=009, 
TERM=3277, 
FEATUR2=(MODEL2,SELPEN), 
ISTATUS=ACTIVE, 
USSTAB=USSNS60 


T60010 LOCAL CUADDR=010, 
TERM=3277, 
FEATUR2=(MODEL2,SELPEN), 
ISTATUS=ACTIVE, 
USSTAB=USSNS60 


T60011 LOCAL CUADDR=011, 
TERM=3277, 
FEATUR2=(MODEL2,SELPEN), 
ISTATUS=ACTIVE, 
USSTAB=USSNS60 


T60012 LOCAL CUADDR=012, 
TERM=3277, 
FEATUR2=(MODEL2,SELPEN)>» 
ISTATUS=ACTIVE, 
USSTAB=USSNS60 


T60013 LOCAL CUADDR=013, 
TERM=3277, 
FEATUR2=(MODEL2,SELPEN), 
ISTATUS=ACTIVE, 
USSTAB=USSNS60 


T60014 LOCAL CUADDR=014, 
TERM=3286, 
FEATUR2=(MODEL2), 
ISTATUS=ACTIVE, 
USSTAB=USSNS60 


160015 LOCAL CUADDR=015, 
| TERM=3277, 
FEATUR2=(MODEL2), 
ISTATUS=ACTIVE, 
USSTAB=USSNS60 


216 


MK KK MxM mK MK KM MK OK MK K XK MM KM XK Mm KK XK 


x KK OK 


Raleigh International Systems Center 


HE HK HE HE HE HEHE IE HEI DE IE HE DE DE HE HK DE DE DE DE HE DE DEE DE DE IE HE DE DE DE IE DE DE DE HE DE DE DE DE IK HE HK DE HE HE HK HE DE HEE DE HE DEE EE HEE DE EE EH 


¥ 


LOCAL SNA MAJORNODE 


x 


HE HE FE HE IE DE HE HE HE DE HE DE HE DE HE HE HE HE HE HE DE HE DE HE SEK IE HE HE HE DE DE DE DK IE DE DK DE IE DE DE IE DE IK DE DE DE DE DE DE DE DE KE DEK EE EK DE DEK DE KE DEE DE EE 


H60L21 


C60041 


T60041 


C60043 


T60043 


VBUILD TYPE=LOCAL 

PU CUADDR=041, 
PUTYPE=2, 
SSCPFM=USSSCS, 
MAXBFRU=5, 


ISTATUS=ACTIVE 


LU LOCADDR=2, 
USSTAB=USSSNA60, 
ISTATUS=ACTIVE 


PU CUADDR=043, 

— PUTYPE=2, 
SSCPFM=USSSCS, 
MAXBFRU=5, 
ISTATUS=INACTIVE 


LU LOCADDR=2, 


USSTAB=USSSNA60, 
ISTATUS=ACTIVE 
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HEE HE HEHEHE HE DEBE DE DE HE DE DE IK HEHE DE IE DE DK DE HE DE IE DE IE DE DE DE HE DE DE NE DE DE NE IE DE DE IC DE DE DHE DE DE DE HC HEHE DE DE EE EEE EE HICH 


% | COMUNICATION ADAPTER MAJORNODE 
DE 3G 3 HEHE HE DE HE HE DE HE IE DE HE DE IE EE DE DE DE HE DE HE HEH DK HE DE DE HEHEHE HE IE HK HE DE HEH DE DE DE IE HE DE DE IE DE IE IE IE DE IK EE DE DEK DE EE 


N601 VBUILD TYPE=CA 
G601 GROUP LNCTL=BSC 


L60030 LINE ADDRESS=030, 
7 SERVLIM=4 


C60030 CLUSTER GPOLL=40, 
CUTYPE=3271, 
ISTATUS=INACTIVE 


T600301 TERMINAL ADDR=40, 
TERM=3277, 
FEATUR2Z=MODEL2, 
ISTATUS=ACTIVE, 
USSTAB=USSNS60 


G602 GROUP LNCTL=SDLC 


L60032 LINE ADDRESS=032, 

| RETRIES=7, 
REPLYTO=1, 
PAUSE=0.1, 
SERVLIM=4 


C60032 PU PUTYPE=5, 
SUBAREA=61 


L60033 LINE ADDRESS=033, 
| RETRIES=7, 
REPLYTO=1, 
PAUSE=0.1, 
SERVLIM=4 


C60033 PU PUTYPE=4, 
SUBAREA=14 
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He HE DE 36 DE HE HEHE DE DE DK DK DE EE DC DK 9 DK DE IE DE DE DE DE DE DK DE DE DE DE DE DK BE DE DE DE DK DK DE DE DE DE DE DK DE DK IE DE DE DE DE DE DK HE IE DE DE DE IE DK IE WK 3K DE 3G DE IE IK 


% PATH MAJORNODE * 
HE EE HE HE HE DEH HE DEE DE DE I HE DK DE HEE OK EDK DEO DE DE DE DK ED DK DK ED IE DE DK DE DE DK DE DE DK OE DK OE DE DK 3 OK HE DE DK DE IE DK 3 OK IE DE OK IC DE IK DE DE 


V601 PATH DESTSA=(10,11,14), x 
ERO=(14,1),ER1=€61,1),ER2=(14,1), x 
VRO=0,VR1=1,VR2=2 

PATH DESTSA=(61), x 
ERO=(€61,1),ER1=(61,1),ER2=(61,1), x 


VRO=0,VRI=1,VR2=2 


DE DK HE 3E 3 DE 3 DK HE DE DE 3K DE 9 3 DE SE DE DE DE DE DE DE DK DE DE DK HE 3 DK KC HE DC HK HE DK HE DE DK IE 3 HK EDK ED DE DK 3 BE HC DHE IE IE KEM KEK RH HH 
* CDRM MAJORNODE % 
EK HEE 3K HE DE HK HE DK HE DE DK ED DE DE DK DE DE BK DE DE DE DE DE DE DK BE DK ED HE DE DE HE DE DE DE DK BE DE DK DED DE DE DK DK DE DE HK HE DE DK IE DK HC DE IEE KEE EM 
M601 VBUILD TYPE=CDRM 

M6060 CDRM SUBAREA=60,CDRDYN=YES,  CDRSC=OPT 

M6061 | CDRM SUBAREA=61,CDRDYN=YES,CDRSC=OPT 


M6011 CDRM SUBAREA=11,CDRDYN=YES, CDRSC=OPT 


HEH HEH HE HEHEHE HEHE HE DE HE HE HE DE DK HK HEE DE HK HE EE DEKH DE DED DK EE DE HE DE DE DE HK HE HEH DK HE DE DE DE DK HK HE EE IE HEE HK HK HEHE EH DK EDK HE 
% | CDRSC MAJORNODE 

DHE HE HE HEE DHE HE HE DE DE DE HE HE DE DE DEH HE DEK DE IK DE DK DK HE DE IK ED DHE DE IK HE DE DK DE DE DE HE OE DE BK DEE DEO HK DE HK HE IE DE HK HE HEI DEE DEE CDE DE 
R60611 VBUILD TYPE=CDRSC 

AG1CICS1 CDRSC CDRM=M6061,ISTATUS=ACTIVE 

A11TSO1 CDRSC CDRM=M6 011, ISTATUS=ACTIVE 


ALLIMS1 CDRSC CDRM=M6011,ISTATUS=ACTIVE 
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A.2 DEFINITIONS IN SA 61 © 


HE HE HE DE IE DE HE DK DE DE IE HE DE DE DE DE DE DE DE DE DE IK DE DE DE DE DK DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DE DK HEE DE DEK DE HE OE EE EE 


x ACF/VTAM START LIST 00 % 
DE 3 3 DEDEDE DE HE DE DE HE DE DE DEDEDE DE DE DE DE IE DE DE DE DE DE DE DE DE DE DEE DE DE DE DE DE HC DE DK DE DE DE IK DE DE DE IE DE DK DE HE DE DIE IE DE IK DE DE EE KEK KK 


SSCPID=61,MAXSUBA=127 ,MAXAPPL=25,HOSTSA=61,PROMPT 


7E HE HE HE HE HK HE HE HE HE HE DE DE DHE DE HE HE HK HE IE DE DE 3G HK DE DE HE HE HE DE DE DE IK DEK DE DE IE DEK DE DE DE DE DE DE HE DE HE DE DK DE DE DE DK DE DEE DE IE 3K DE EOE HE EEK 


% ACF/VTAM START LIST 61 
HEE HK HE DK HEE DK DE HE DE DK IE DE DE DE DE IE DK DE DE DK DK DE DE DK DE DE DE DE DK DE DE DE DK DE DE DK DK IE DE DE DE DE DE DK DE DE DK DE DE DE DE DE DE DE DE 3E DE DE DE DE DE IE IE 3E DE EDK 


SSCPID=61, CONFIG=61,MAXSUBA=127 ,MAXAPPL=25,HOSTSA=61,VPBUF=20480 


titi tietitretitititititetitttittttittititetetittititittiittitettttteret. 


% CONFIGURATION LIST 61 % 
HEE HEHE DE HE DE IE HE DE DK DE DE DE DE DE DE HE DE DE DE DE HE DE DK DE DE DE DE DE HE DE DE DE DEDEDE HE DE DE DK HE DE DE DE DE DE DE DK DE DE DK HE DE DE DE DE DE IE DK HC DE DE HE DE HK HE DE IE IK 


A611, H61111,H61121,N611,V611,M611,R61601 


HE HEHE HH HEHE HE HEH HEHE HE HE HK HEHE HEHE HE HE IE HE HEE DE HEHE DE HE HK HEE HE HE IE HK HE DE DE IE DEE HE KE HE HE KK EE EH HK KE EH EEK HE HEE HK 
x | APPLICATION MAJOQRNODE x 
HEHE HE DE HE IE HEHE HE IE HE IE HE DE IE EDK IE HE IE DE HE HE IE HE DE DE IEE DE IE EK DENK DE DE EK HE DE DE DE DE DE DE IK DEK CIE DE KE DEE DE EE EE KEK 


A61CICS1 APPL AUTH=CPASS,ACQ) 
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HE HEHE HE IK HE HE HE HE HE HK IE HE HE HE HE HK DE HE HE IE HK HE HK IE HK HE EE HE DE EE HE HE HK EK HE DE HE SE DE HE DE DEK DEK DE HE HEE HE DE HE EE EK KE KEK KH HK 


OCAL NON-SNA MAJORNODE - DISPLAY PRINTER ADAPTER ss 
HE 9 HE 3G 9 HE HE 3 DK HE DE DE DK DE DE DE DK HE DE DK ED DK 3 3 OK HE 3 DK DEE DE DK DE HE DE DK DE DE DK DE DE 3K DE DE DK HE DE DK DE DE DE DC HK DE DK DE DK HE DE DE IK KEE EE 


% 


H61L11 


761009 


T61010 


T61011_ 


T61012 


161013 


T61014 


T61015 


L 


LBUILD 


LOCAL 


LOCAL 


LOCAL 


LOCAL 


LOCAL 


LOCAL 


LOCAL 


CUADDR=009, 

TERM=3277, 
FEATUR2=(MODEL2,SELPEN), 
ISTATUS=ACTIVE, 
USSTAB=USSNS61 


CUADDR=010, 

TERM=3277, 
FEATUR2Z=(MODEL2,SELPEN), 
ISTATUS=ACTIVE, 
USSTAB=USSNS61 


CUADDR=011, 

TERM=3277, 
FEATUR2Z=(MODEL2,SELPEN), 
ISTATUS=ACTIVE, 
USSTAB=USSNS61 


CUADDR=012, 

TERM=3277, 
FEATUR2=C(MODEL2,SELPEN), 
ISTATUS=ACTIVE, 
USSTAB=USSNS61 


CUADDR=013, 

TERM=3277, 
FEATUR2=(MODEL2,SELPEN), 
ISTATUS=ACTIVE, 
USSTAB=USSNS61 


CUADDR=014, 
TERM=3286, 
FEATUR2=(MODEL2), 
ISTATUS=ACTIVE, 
USSTAB=USSNS61 


CUADDR=015, 

TERM=3277, 
FEATUR2=(MODEL2,SELPEN), 
ISTATUS=ACTIVE, 
USSTAB=USSNS61 
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9 96 36 96 HE HEED DK IK IE HE HE HED DK DK HC 3 DK HC HE HC 3 3 3 DDK IK IE HC HE HE DDK OK IK DE HE DEO DK DE CE ECD DK DE DEE 9 DEED DE I HE HE HED OK DE DED 


x LOCAL SNA MAJORNODE — : x 
3 3 36 96 3 DE DE 9E DE DK DE DE HE IE DE DE DK 3 6 9€ HE 0G DE BE DE DE 3 HE DE DE DK 3 DE IE ODE DK 3 EC OE OD DE DE DE 3 DO DD DE 9 DD D9 I 9 OO 3 


H61L21  VBUILD TYPE=LOCAL 


P611L3F PU CUADDR=15F;, 
PUTYPE=2, 
MAXBFRU=5, 
ISTATUS=INACTIVE 


T6LISFL LU LOCADDR=2, 
ISTATUS=INACTIVE, 
USSTAB=USSSNA61 


T6113F2 LU LOACCDR=3, 
| | ISTATUS=INACTIVE, 
USSTAB=USSSNA61 


T6LA5FS5 LU LOACCDR=4, 


ISTATUS=INACTIVE, 
SSTAB=USSSNA61 
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HEHE HE HE HEHE HE HK HE HE DE HE EK HE KE HE KE EK HE HE EK IEE EK DEE HE EK HE HE DEE HE HK HE HEH HK HK HH HK KH KK KKK KK KKK KKH 


x 


COMUNICATION ADAPTER MAJORNODE 


HE HK HE HEHE HEE HE HK BE KEK HE KEK EK HE HK HEHE EK EHH EK EK KK HK EK HK HK HH HEH EHH HK KHER K HK KK KKK KKKKKKRK KH 


N611 
G6l12 


L61031 


C61031 


T61031 


T61031 


L61032 


C61032 


VBUILD TYPE=CA 
GROUP LNCTL=SDLC 


LINE ADDRESS=03i, 
RETRIES=7, 
REPLYTO=1, 
PAUSE=0.1, 
SERVLIM=4 


PU ADDR=Cl, 
PUTYPE=2, 
SSCPFM=USSSCS, 
MAXDATA=262, 
MAXOUT=1, 
ISTATUS=INACTIVE 


i Lv LOCADDR=2, 
ISTATUS=ACTIVE, 
USSTAB=USSSNAG1 


2 LU LOCADDR=3, 
ISTATUS=ACTIVE, 
USSTAB=USSSNA61 


LINE ADDRESS=032, 
RETRIES=7, 
REPLYTO=1, 
PAUSE=0.1, 
SERVLIM=4 


PU PUTYPE=5, 
SUBAREA=60 
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ittttitiristititritirittitittititititttstrtestetereest reset reeset ergy 
% PATH MAJORNODE 3 % 
DED HK HK HE HE HE HE HEED DK DK DD DK DC 33 DE DK DK DK DK DC DO 9 DD 3 9 9 3 
V611 PATH DESTSA=(10,11,14), 
ERO=(14,1),ER1=(14,1),ER2=(60,1), 
VRO=0,VRI=1,VR2=2 
PATH DESTSA=(60), 


ERO=(60,1),ER1=(60,1),ER2=(60,1), 
VRO=0,VR1=1,VR2=2 


HEH HEHE DEE DE DE HE DE IEE HE HE DE DE DK DE DE DE DK HE DE HE HE DE DK 3 DED IE DE DE DE DK HE DE DE DE DE DE DE DK EDK DE DK IE DE IE DC DE 3 DE DE DE 3 DE DE DE DEE 3 DE IK IK IE 
* CDRM MAJORNODE % 
HEH HEH HE HE HE HEE HEE DE EE DE DK DE DE DE DE DK DE DE BIE DE DK ED IE DE DK EDK HE DE DK DE DE DK DE DE DK IE DE DK IE DE DE HE DK IK 3 DE DE DK DK DE DK DK DE DE OK DE DE HK CE 
M611 VBUILD TYPE=CDRM 

M6161 CDRM SUBAREA=61,CDRDYN=YES,CDRSC=O0PT 

M6160 CDRM SUBAREA=60 , CDRDYN=YES , CDRSC=0PT 


M6111 CDRM SUBAREA=11,CDRDYN=YES, CDRSC=0PT 


363 HE HEE N HHH HEH HH HEI HH HED HHI HD DW III 
x CDRSC MAJORNODE 7 

PE Pe Pest ePerere seers ese Pere reser eS ESE S PSE PEPE PES PSPS ESE SSPE SESE SESE SS S 
R61601 VBUILD TYPE=CDRSC 

AGOCICS1 CDRSC CDRM=M6160,ISTATUS=ACTIVE 

A11TSO1 CDRSC CDRM=M6111,ISTATUS=ACTIVE 


AL1IMS1 CDRSC CDRM=M6111,ISTATUS=ACTIVE 
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B.0 NAMING CONVENTIONS 


Names based on the format below are assigned to lines, physical units 
CPUs) and logical units (LUs). These names are identified to ACF/VTAM V2 
through definition statements. 


The names are also used by the network operator and should be known to the 
terminal end users for proper identification of failing components during 
problem determination and correction. Without a good naming convention, 
operation and maintenance of the network becomes difficult. 
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AGF/VTAM Ve - Single System 


Names based on the format below are assigned to lines, physical units 
CPUs) and logical units (CLUs). These names are identified to ACF/VTAM V2 
through definition statements. | 


The names are also used by the network operator and should be known to the 
terminal end users for proper identification of failing components during 
problem determination and correction. Without a good naming convention, 
operation and maintenance of the natwork becomes difficult. 


The following conventions for a Single system environment are based on the 
SIPO 3.1 supplied samples. 


However, it is not recommended that you use device dependent names (e.g. 
LU names of the form ttmLcuu). This is rather inflexible and does not 
allow for new devices. 


Instead, a single system user might choose the multisystem naming con- 


ventions, disregarding definitions which do not apply, or possibly a com 
bination of the two. 
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SINGUE DOMAIN 
TYPE 12345678 


Application Major Node APPL #v 


DBDCCICS 
TESTCICS 


Application Minor Node 


Local non-SNA Major Node LOC#y 


Terminal (MN) ttmbcouu 


Local SNA Major Node LOC# 


PU (MN) PUcuu 


LU (MN) ttmLouu# 


CA Majornode REM#v 


Group GROUP# 


Line LINElia 


Cluster/PU (MN)? Cllia 


Terminal/LU (MN) ttmRouut 


Figure 43. VTAM Naming Conventions ina Single System Environment 


tt = terminal type 

m = model/screen 
cuu = physical address for local davices, clusters 
lia = physical address of the connection (line) 

# = sequence number 

Vv = variation number 


may be used for variations in major node names 
Ce.g. lines originally ACTIVE or INACTIVE, 
different hardware definition,...) 
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The following figure shows a list of possible devices types used as ttm in 
the naming conventions. 


364X% X = 1 
379078100 
3600 

3614 

3650 

3660 

3275 

3276 

3276 

3276 

3276 

3277 

3277 

3278 

3278 

3278 

3278 C43 x 80) 
3278 (2? 132) 
3279 2A and 2B 
3279 SA and 3B 
3284 

3284 

3284 

3286 

3286 

3286 

3287 


C12 
C24 
C32 
(43 
C12 
C24 
C12 
C24 
C32 


80) 
80) 
80) 
80) 
40) 
80) 
80) 
80) 
80) 


teu ou ou 


OPW De Pa eM 
XMM KK KKK KK XK 


om 
Lad 
tee 
—_ 
me 
wet 
ren 
= 
bed 
am 
~~ 
= 
=: 
—_ 
~~ 
= 
wn 
eon 
—_ 
ey 
wae 
=. 
A cad 
beste 
Ld 
Aad 
—_ 
td 
—_ 
= 
Rcd 
A aed 
~ 
ome 
bd 
re 
— 
—_ 
Cai 
Lad 
ae 
ame 
= 
~m 
bad 
—= 
7 
ood 
b emead 
—_e 
owe 
bl 
oe 
ans 


Figure 44. Terminal Table for the Use in Naming Conventions 
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cIcs/vS - Single System 
Like the ACF/VTAM V2 major and minor node names the TRMIDNT (parameter in 
the TCT TYPE=TERMINAL macro) have to be unique. 


In accordance with the SIPO/E 3.1 supplied VTAM TCT (CDFHTCTS$O), use fol- 
lowing names: 


TYPE 1234 MNEMONIC 
TRMIDNT | L#Tn 
R#Tn 


Figure 45. CICS/VS Naming Conventions ~ Single System 


ocal terminal 


L=L 
R = Remote terminal 


L¥Tn/LEPn for local terminals/printers 
R#¥Tn/R#EPn for remote terminals/terminal printers 


# 
n 


number of the ACF/VTAM V2 major node 
position of this terminal/printer in the ACF/VTAM V2 
major node (e.g. 0 to 9, A to ....3 
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ACF/VTAM V2 ~ Multi-System 


This naming convention is based on a two digit subarea definition. 


Figure 46. 
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TYPE 


Application Major Node — Assv 


AssCIcsv 
AssPOWyv 
AssNv 


Application Minor Node 


Local non-SNA Major Node |. Hssl#v 


Tarminal Tsscuu 


Local SNA Major Noda Hssl#v 


PU Psscuu 


LU Tsscuu# 


CA/NCP Major Node Nssi#tv 


Switched Major Noda Ssstv 


Group Gssi# 


Line Lsslia 


Cluster/PU Psslia(C#) 


Tarminal/LU Tsslial#)#, 


Path Table Vssv 


Path 


Vssdd 


Path (Switched Defn.) VSsst 


12345678 


if 


it ou 


MNEMONIC | 


Application 


CICS/vVS 
POWER RJE/PNET 
NCCF | 


Host attached 
Local 


Terminal 


Host attached 
Local 


= Pysical Unit 


CA/NCP 
Switched 
Group 

Line 
Cluster/PU 
Terminal 


Path 


VTAM Naming Conventions in a Multi System Environment 
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a. 
a. 
mo ot 


on multipoint lines 


es 
y 
te se | | 


sequence number 
CA/NCP line address 
physical address of the connection 


subarea number (max. = MAXSUBA) of this domain 
destination subarea number 
sequence number only used for devices 


for local devices and clusters 


same subarea 


12345678 


TYPE 


CDRM Major Node 


CDRM Minor Node 


CDRSC Major Node 


CDRSC Minor Node 


Figure 47. 


ss 
dd 


Mssv 


Mssss 
Mssdd 


RssddAtv 


RssddT#v 


AddCiIcsSv 
Tddcuu# 


this subarea number (max. 
subarea number of the participating cross domain 


(destination) host 
for applications and terminals 


= =) 
ft ott 


sequence number 
variation number used for variations within the 


same subarea 


Ce.g. 


Notes 


Users of SSX systems should take into consideration the naming convention 
used by 55X. This is shown in SSX/VSE Pregeneration Specifications, 


page 66 on. 


57) All the minor nodes (LUs 


original names. 


variation number used for variations within the 


MNEMONTIC 


M = Manager 


CDRM in SA ss 
CDRM of SA dd 


Applications in 
SA = dd 
Terminals in 


SA = dd 
57 


Naming Conventions for Cross Domain Definitions 


= MAXSUBA) 


minor node originally ACTIVE or INACTIVE) 


or APPLs) per CDRSC major node retain their 
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CICS/VS5 - Multi~-System 


Like the ACF/VTAM major and minor node names the TRMIDNT parameter Cin the 
TCT iVEE= TERMINAL macro) have to be unique. 


Based on experiences in many installations the following naming conven- 
tion is racommended: 


Figure 48. CICS/VS Naming Conventions ~ Multi-System 


a = alphabetic character for each CICS/VS system 
(a.g. A for CICS/VS in SA=60, 
B for CICS/VS in SA=61, etc. ...) 


### = position of the terminal in an ACF/VTAM V2 major node 
Ce.g. 0 to 31 for terminals in the first major node, 
32 to 63 for terminals in the second major node, 
te... «icc? 


The suffix of the CICS/VS tables CTCT,PCT,PPT,SIT) may reflect the subarea 
number. 
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C.0 DOCUMENTATION SUMMARY 


More detailed information on various subjects mentioned in this primer can 
be found in the IBM publications listed below. 


C.1 ACF/VTAM V2 PUBLICATIONS SUMMARY 


The following manual is the index of the ACF/VTAM V2 library. 


ACF/VTAM V2 Master Index GX27-0032 


This manual contains a listing of topics discussed in the ACF/VTAM V2 
manuals. 


The following manual deals with evaluation and education: 


ACF/VTAM V2 General Information GC27-0608 


This manual contains general information about the facilities and 
requirements of ACF/VTAM V2. It jis intended primarily for use by 
installation managers and planners who are evaluating ACF/VTAM V2 for 
inclusion in their data communication system. This book is directed 
primarily to those whose who require an elementary introduction to the 
concepts that underlie ACF/VTAM V2. 


The folloning publication discusses installing ACF/VTAM V2: 


ACF/VTAM V2 Planing and Installation Reference S$C27-0439 


The purpose of this book is to enable management personnel and system 
programmers to understand planning requirements when preparing to 
install an ACF/VTAM V2 system. It describes how to define, tailor, 
and maintain an ACF/VTAM V2 system. It includes information on the 
choice and specification of installation options and information on 
definition of devices and programs. 


The following manual discusses writing ACF/VTAM V2 application programs: 


ACF/VTAM V2 Programming $C€27-0611 


This manual contains information about how to write application pro- 
grams that contain ACF/VTAM V2 macro instructions and explains how to 
code those ACF/VTAM V2 macro instructions. 


The following manuals discuss the ACF/VTAM V2 operation: 


ACF/VTAM V2 Operation $C27-0612 
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~ This publication contains detailed information about commands used 


to run an ACF/VTAM V2 domain. It may be used as reference manual for 
domain operators as well as a guide for system programmers who provide 
detailed information needed to run the domain. | | 


ACF/VTAM V2 Messages and Codes §C27-0612 


This is a reference manual for ACF/VTAM V2 messages and related codes. 
All information needed to interpret ACF/VTAM V2 messages Cidentified 
by the prefix 5) is contained in this manual. This publication con- 
tains also messages that can be displayed or printed at a terminal 
operated by the terminal user, or a network, e.g. domain operator, 
Teleprocessing Online Test (TOLTEP) messages and messages issued by 
the unformatted system Services (USS) portion of ACF/VTAM V2. 


The following manuals help to detect, diagnose and fix possible problems: 


C.2 


ACF/VTAM V2 Diagnosis Guide ~$C27-0630 


ACF/VTAM V2 Diagnosis Reference LY38~-3058 


ACF/VTAM V2 Data Areas | LY38-3059 


These shows the use of the diagnostic facilities available through 
ACF/VTAM V2. It provides a diagnostic approach to debugging ACF/VTAM 
V2, and contains guidelines and debugging aids to assist system and 
application programmers. The primary purposes of these manuals are to 


1. provide information that enables the reader to use ACF/VTAM v2 
diagnostic aids to determine where the cause of a failure lies and 


2. to summarize serviceability aids described in other publications. 


ACF/VTAM V2 Reference Summary ~—~§X27-0027 


This shows the use of the diagnostic facilities available through 
ACF/VTAM V2. 


SIPO/E PUBLICATIONS SUMMARY 
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SIPO/E Release 3.1 Reference Manual 

SIPO/E Release 3.1 Program Directory 

GC20-1933 SIPO/E User's Guide Release 3.1 

$H20-2486 IPF VSE Feature Reference Manual seiwaae 4.1 


SH20-5526 IPF VSE Feature User's Guide Release 4.1 


Raleigh International Systems Center 
C.3 OTHER INSTALLATION PRIMERS 
y GG24-1519 Small Communications Systems Installation Primer, 


IBM 4331/7ACF/VTAME 


e 6624-1552 Small Communications Systems Installation Primer, 
VSE SYSTEM IPOZE & IBM 3705-80 


c¢ LI 


*  6C27-0429 NCCF General Information 
©  §C27-0430 NCCF Installation 

e 5C27-0451 NCCF Massages 

©  $0C27-0432 NCCF Terminal Use 

e $027-0433 NCCF Customization 


° GG24-1554 CNM Customizing NCCF 


DA _PUBLT TONS SUMMA 


e G6C34-2010 NPDA General Information 
¢ §C34-2011 NPDA Installation 
° $C034-2012 NPDA Messages and Codes 


° $€034-2032 NPDA User Action Guide 


C.6 OCCF PUBLICATIONS SUMMARY 


e G6C33-6113 General Information 
® $C033-6115 Installation Guide and Reference 


e §$€33-6117 Diagnosis Guide 
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C.7 OTHER PUBLICATIONS ~ 


© GA24-3667 
© GA33-1525 
© GA33-1526 
© GA27-2749 
© GA18-2081 
© GA23-0061 
© GA18-2042 
© GA27-2871 
©  GA27-2850 
©  GC20-1878 
© 6033-6094 
®©  6C33-6097 
© GC33-6111 
© $C33-0069 
© $§C33-0070 
© 2220-2873 
© 6320-6023 
© 6320-6028 
© 6624-1514 


® GG24-1523 


IBM 4300 Physical Planning 

IBM 4331 Operating Procedures 

IBM 4331 Functional Characteristics 

IBM 3270 Component Description 

IBM 3276 Control Unit Description and Programmer's Guide 
IBM 3274 Control Unit Description and Programmer's Guide 


IBM System Problem Determination for 3276 Display Stations 


IBM System Problem Determination for 3274 Control Units 


IBM 3274 Control Unit Problem Determination Guide 
A Guide to IBM 4331 Processor 

VSE/VAF System Management Guide 

VSE/AF Operating Procedures 

VSE/AF MHSP User's Guide 

CICS/VS System Programmer's Reference Manual 
CICS/VS System Programmer's Guide 

IBM 4300 Installation Planning Checklist 

SNA 327473278 Installation Guide 

SNA Product Installation Guide 

SNA System Problem Determination Guide - Volume 1 


SNA System Problem Determination Guide ~- Volume 2 


For Loop Adapter and IBM 364X Users 


©  GA23-0038 
© GA23-0039 
© GA23-1523 


©  GA23-1534 


Communication Loop Planning Guide 
Multiuse Communication Loop Installation Guide 
IBM 4300 Funct. Character. and Processor Complex Config. 


IBM 4300 Loop Adapter Functional Characteristics 


e GA23-1538 IBM 4300 Loop Adapter Operating Procedures 
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For IBM 3644 Users 


GA23-1540 
$C31-0500 
GC31-0505 
LC31-1500 
GA24-3679 
GA24-3680 
GA24-3681 
GA24-3711 
GA24-3683 


GC31-2011 


~GA27-3253 


GA33-3040 


GA33-3041 
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IBM 4300 Loop Adapter Problem Determination Guide 


Loop Adapter CICS/VS PRPQ Programmers Guide 


Loop Adapter CICS/VS PRPQ Specifications 


Loop Adapter CICS/VS PRPQ Logic Overview 


IBM 


IBM 


IBM 


IBM 


IBM 


IBM 


IBM 


IBM 


IBM 


364] 


3642 


3643 


3645 


3646 


3647 


3843 


8775 


8775 


Rep. Term. Component and Operator Description 
Enc. Prt. Component and Operator Description 
Key. Disp. Component and Operator Description 
Printer Component and Operator Description 
Scanner Contr. Unit Comp. and Oper. Description 
Time and Attendance Comp. and Oper. Description 
Loop Control Unit Introduction Guide 

Display Terminal Introduction 


Display Terminal Character Set Reference 


GA24-3653 IBM 3644 Aut. Data Unit Component Description 


GC31-0009 Parameter Table Generation Facility 


For IBM 32644 and IBM 8775 Cenhanced/ext. functions) Users 


GC33-6125 Downstream Load Utility Programming Summary 


G6C33-6126 Downstream Load Utility Specifications 


GC33-6127 Downstream Load Utility Installation and Reference Guide 


LY33-9099 Downstream Load Utility Diagnosis Guide 
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D.0 CONFIGURATION DOCUMENTATION WORKSHEETS 


| CLUSTER 7 CONTROL UNIT | 


TYPE FEATURES SERIAL NUMBER 
- SET UP DATE _74%_ 7 PERSON 


MAJOR NODE NAME incl. in ATCCON __ 


TERMINAL 


ADDRESS ___ 
_. FEATURES __—_——C—C—CCUSSERRXALL. NUMBER 
MINOR NODE NAME “__ ISTATUS LOGAPPL 
USSTAB MODETAB DLOGMOD 
APPLICATIONS 

TRMIDNT 


TERMINAL 


ADDRESS ___ 
FEATURES SERIAL NUMBER 


MINOR NODE NAME | ISTATUS : LOGAPPL | 
USSTAB MODETAB DLOGMOD 
APPLICATIONS 

TRMIDNT 


TERMINAL 


ADDRESS 
os FEATURES SERIAL NUMBER 
MINOR NODE NAME _._ ~OISTATUS _ OO CLOGAPPL 
USSTAB MODETAB DLOGMOD 
APPLICATIONS 

TRMIDNT 


Figure 49. Configuration Documentation Worksheet: Control Unit 
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| | TERMINAL | 


PORT _. ADDRESS 
TYPE _.. FEATURES 


SERIAL NUMBER 


MINOR NODE NAME ISTATUS LOGAPPL 
USSTAB MODETAB _ DLOGMOD 
APPLICATIONS 

TRMIDNT 


| | TERMINAL | | 


PORT _. ADDRESS 
TYPE _.. FEATURES | SERIAL NUMBER 


MINOR NODE NAME ISTATUS __ LOGAPPL 
USSTAB MODETAB DLOGMOD 
APPLICATIONS 
TRMIDNT 

" ¢ TERMINAL 
PORT _. ADDRESS | 


TYPE FEATURES 


SERIAL NUMBER 


MINOR NODE NAME ISTATUS LOGAPPL 
USSTAB MODETAB DLOGMOD 


APPLICATIONS 
TRMIDNT 7 
‘TERMINAL | 
PORT __ ADDRESS 


TYPE FEATURES SERTAL NUMBER 


MINOR NODE NAME ISTATUS LOGAPPL 
USSTAB MODETAB DLOGMOD 
APPLICATIONS 

TRMIDNT 


Figure 50. Configuration Documentation Worksheet : Terminals 
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‘Staples can cause problems with automated mail sorting equipment. 


Note: 


Please use pressure sensitive or other gummed tape to seal this form. 
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Small Communications Systems Installation READER'S 
Primer: IBM 4331 - ACF/VTAM Version 2 COMMENT 
FORM 


You may use this form to communicate your comments about this publication, its organization, or 
subject matter, with the understanding that IBM may use or distribute whatever information you 
supply in any way it believes appropriate without incurring any obligation to you. 

Your comments will be sent to the author’s department for whatever review and action, if any, is 
deemed appropriate. Comments may be written in your own language; use of English is not required. 


Note: Copies of IBM publications are not stocked at the location to which this form is addressed. 
Please direct any requests for copies of publications, or for assistance in using your IBM system, to 
your IBM representative or to the IBM branch office serving your locality. 

Possible topics for comment are: 


Clarity Accuracy Completeness Organization Coding Retrieval Legibility 


If you wish a reply, give your name, company, mailing address, and date: 


What is your occupation? 


Number of latest Newsletter associated with this publication: 


Thank you for your cooperation. 
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